Team Domains

Team domains let you automatically add new users to your team based on their email address. When you verify a domain like company.com, anyone who signs up with an @company.com email address is automatically added to your team.

This streamlines onboarding for organizations where team members share a common email domain. A verified domain is also what lets your team create flow monitors that reach it.

How It Works

1. You add and verify a domain (e.g., company.com)

2. A new user signs up with an email like jane@company.com

3. The user is automatically added to your team upon registration

No manual invitations required. Team members can start collaborating immediately after signing up.

Adding a Domain

1. Open Settings in the sidebar

2. Under Domains, click Add Domain

3. Enter your domain (e.g., company.com) in Domain

4. Click Add Domain

The domain appears in your list as Awaiting verification. You must verify ownership before auto-provisioning takes effect.

Verification Process

Domain verification uses a DNS TXT record to confirm you control the domain. This prevents unauthorized teams from claiming domains they don't own.

Step 1: Copy the Verification Record

After adding a domain, the Verification ID column shows its unique value, such as ping_0190f3a2-…. Copy it exactly as shown, or use Copy Verification ID from the domain's Actions Menu.

Step 2: Add the DNS Record

Log into your DNS provider (Cloudflare, Route 53, GoDaddy, Namecheap, etc.) and add a new TXT record:

For example, if you're verifying company.com:

• The Name field should be _ping-verification (some providers may require _ping-verification.company.com)

• The Value field should be the full Verification ID, including its ping_ prefix

Step 3: Wait for DNS Propagation

DNS changes can take anywhere from a few minutes to 48 hours to propagate globally, though most providers propagate within 5-15 minutes.

You can check if your record has propagated using online DNS lookup tools or by running:

dig TXT _ping-verification.company.com

Step 4: Complete Verification

Once the DNS record is in place:

Uptime checks pending domains for the TXT record on its own. To check right away:

1. Return to Settings and find your domain under Domains

2. Open its Actions Menu

3. Choose Retry Verification

When the record is found and matches, Verified At shows the date and auto-provisioning becomes active.

Auto-Provisioning Behavior

Once a domain is verified:

• New signups: Users who register with a matching email domain are automatically added to your team

• Existing users: Users who already have accounts are not automatically added. You must invite them manually

• Role assignment: Auto-provisioned members receive the default member role. Admins can adjust roles after they join

• Multiple teams: If multiple teams have verified the same domain, users are added to all of them

Managing Domains

Viewing Domain Status

Open Settings and look under Domains to see all your domains and their status in the Verified At column:

• A date: Domain is verified and auto-provisioning is enabled

• Awaiting verification: Domain added but its TXT record hasn't been found yet

Removing a Domain

To remove a domain:

1. Open Settings and find the domain under Domains

2. Open its Actions Menu

3. Choose Remove Domain

You can optionally remove the TXT verification record from your DNS provider after removing the domain.

Multiple Domains

You can verify multiple domains for a single team. This is useful if your organization uses multiple email domains:

• company.com

• company.co.uk

• subsidiary.com

Each domain requires its own verification process.

Common Issues

Verification Failing After Adding Record

DNS hasn't propagated yet. Wait 15-30 minutes and try again. In rare cases, propagation can take up to 48 hours.

Wrong record type. Ensure you created a TXT record, not a CNAME or A record.

Incorrect record name. Double-check the hostname/name field matches exactly what Uptime expects. Some providers automatically append your domain.

Value mismatch. Copy the Verification ID exactly as shown, including the ping_ prefix. Don't add quotes or extra spaces.

Record Shows in DNS but Verification Still Fails

Some DNS providers add quotation marks around TXT values automatically. If you added quotes manually, you may have double quotes in the actual record. Remove any quotes you added and let the provider handle formatting.

Users Not Being Auto-Provisioned

Domain not verified. Check that Verified At shows a date for the domain in Settings.

User already exists. Auto-provisioning only applies to new signups. Existing users must be invited manually.

Email domain doesn't match exactly. The email domain must match the verified domain exactly. Subdomains are not included (e.g., verifying company.com does not cover mail.company.com).

Can I Use Subdomains?

Yes, you can verify subdomains separately. If your team uses team.company.com email addresses, verify team.company.com as its own domain.