Skip to content

Commit 3adb39e

Browse files
committed
docs: Add page on domain verification
1 parent f1479b8 commit 3adb39e

File tree

2 files changed

+65
-2
lines changed

2 files changed

+65
-2
lines changed
Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
import { DocImage } from "@doc";
2+
3+
# Verify your team email domain
4+
5+
## Why should I verify my domain?
6+
7+
- Verified badge: Your team gets a special badge, so it’s easier to confirm you're in the right place.
8+
- Recommended team members: On the Settings → Members page, you’ll see users with emails that match your domain but aren’t in the team yet — making it super easy to invite everyone on the team.
9+
- Instant invite alerts: Team owners will get a notification (in the dashboard and optionally via email) when someone signs up with your verified domain — with a 1-click invite option.
10+
11+
## How to verify your domain
12+
13+
1. Navigate to [Team Settings](https://thirdweb.com/team/~/~/settings) and look for *Domain Verification*.
14+
1. Enter your domain name.
15+
- Your domain name is the part after the `@` symbol in your company email address. It is NOT a website and should not contain `https://` nor `www`.
16+
1. You should see instructions to add a `TXT record` on your domain to complete verification.
17+
- Type: TXT
18+
- Name/Host: `_tw-<YOUR_TEAM_ID>.<YOUR_DOMAIN>`
19+
- Value: `tw-verify=<YOUR_VERIFICATION_CODE>`
20+
- See below for provider-specific instructions.
21+
22+
thirdweb will automatically detect the TXT record once it's live. DNS changes may take several hours to update.
23+
Check this dashboard page periodically to confirm when it's completed.
24+
25+
### Verify your TXT record
26+
27+
Use a tool like [MxToolbox](https://mxtoolbox.com/txtlookup.aspx) or `dig` in the command line to check if your TXT record is correct.
28+
29+
```bash
30+
$ dig +short -t txt _tw-<TEAM_ID>.<YOUR_DOMAIN>
31+
32+
# If correct, you should see this response:
33+
"tw-verify=<YOUR_VERIFICATION_CODE>"
34+
```
35+
36+
## Provider-specific instructions
37+
38+
### Cloudflare
39+
40+
- Navigate to the Cloudflare dashboard.
41+
- Select your zone and domain.
42+
- Select *DNS* > *Records*.
43+
- Select *Add record*.
44+
[Cloudflare documentation](https://www.cloudflare.com/learning/dns/dns-records/dns-txt-record/)
45+
46+
### AWS Route 53
47+
48+
- Navigate to the Route 53 console.
49+
- Select *Hosted Zones* and select your domain.
50+
- Select *Create record*.
51+
[AWS Documentation](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-creating.html)
52+
53+
### Google Cloud DNS
54+
- Navigate to the Google Cloud Console.
55+
- Select *Network Services* > *Cloud DNS*.
56+
- Select your zone.
57+
- Select *Add record set*.
58+
[Google Cloud documentation](https://cloud.google.com/dns/docs/records#add-rrset)

apps/portal/src/app/knowledge-base/sidebar.tsx

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,12 +22,17 @@ export const sidebar: SideBar = {
2222
icon: <BracesIcon />,
2323
links: [
2424
{
25-
name: "Creating Soulbound NFTs",
25+
name: "Verify your team email domain",
26+
expanded: true,
27+
href: "/knowledge-base/how-to/verify-your-team-email-domain",
28+
},
29+
{
30+
name: "Creating soulbound NFTs",
2631
expanded: true,
2732
href: "/knowledge-base/how-to/creating-soulbound-nfts",
2833
},
2934
{
30-
name: "Console Error Sharing",
35+
name: "Console error sharing",
3136
expanded: true,
3237
href: "/knowledge-base/how-to/console-error-sharing",
3338
},

0 commit comments

Comments
 (0)