Skip to main content
To use Phantom Connect in production and to have your app appear in Phantom’s public surfaces, you must verify the domain where your app runs. Domain verification confirms ownership of the domain and helps protect users from phishing and impersonation. Verification is required in several situations. In particular, you must verify your domain before the following actions are allowed:
  • Using Phantom Connect SDKs in production
  • Allowing users outside your team to connect
  • Appearing in Phantom’s Explore tab, search results, or recommended apps

Add your domain in Phantom Portal

  1. In Phantom Portal, go to Edit App Info.
  2. Find the Public URL field.
  3. Enter your app’s primary domain, for example https://yourapp.com.
  4. Select Save.
Enter only your root domain or primary subdomain. Do not include paths such as /app, /login, or /dashboard.

Get your verification code

After saving your domain, Phantom Portal generates a verification code for you.
  1. Locate the Domain Verification section.
  2. Copy the verification code shown. It will look like phantom-verification-XXXXX.
Phantom Portal showing the verification code

Add the DNS TXT record

Add a TXT record to your domain’s DNS settings using the verification code.
FieldValue
TypeTXT
Host / Name@ (or leave blank, depending on provider)
ValueThe verification code from Phantom Portal
TTL3600 or your provider’s default

Common DNS providers

  1. Open the Cloudflare dashboard.
  2. Select your domain.
  3. Go to DNS → Records.
  4. Add a TXT record with name @ and the verification code as the value.
  5. Save your changes.
  1. Open GoDaddy and go to DNS settings for your domain.
  2. Add a new TXT record.
  3. Use @ as the host and paste the verification code as the value.
  4. Save your changes.
  1. Go to Domain List → Manage → Advanced DNS.
  2. Add a TXT record.
  3. Use @ as the host and paste the verification code as the value.
  4. Save your changes.
  1. Open the Route 53 console.
  2. Select your hosted zone.
  3. Create a TXT record at the root.
  4. Paste the verification code as the value and save.
  1. Open your project settings.
  2. Go to Domains and select your domain.
  3. Add a TXT record using the verification code.
  4. Save your changes.
If you’re not sure where your DNS is managed, check your domain registrar or hosting provider.

Complete verification

DNS changes usually propagate within 15 to 60 minutes, but may take up to 48 hours. You can check propagation using the following command:
nslookup -type=TXT yourapp.com

## Troubleshooting

### Verification fails

If selecting **Verify Domain** returns an error, try the following steps:

- Wait for DNS propagation to complete, which can take up to 48 hours
- Confirm that the TXT record value matches the verification code exactly.
- Remove any quotation marks added automatically by your DNS provider.
- Ensure the TXT record is added at the root domain (@), not to a subdomain unless required.
- Check the record using a different DNS lookup tool.
- Clear your local DNS cache using the following commands:

```bash
# macOS
sudo dscacheutil -flushcache

# Windows
ipconfig /flushdns

Multiple TXT records

If your domain already has TXT records, you can safely add another one for Phantom verification. DNS supports multiple TXT records on the same domain, so don’t remove or overwrite existing records.

Subdomain or root domain

If you’re unsure which domain to verify, use the domain where users actually access your app:
  • Verify app.example.com if your app runs on that subdomain.
  • Verify example.com if your app runs on the root domain.

DNS changes not saving

If your DNS provider doesn’t save the record, the issue is often related to formatting or permissions. Try the following:
  • Remove quotation marks from the TXT value.
  • Check for trailing periods or extra whitespace.
  • Confirm that you have permission to edit DNS records for the domain.
  • Contact your DNS provider’s support team if the issue persists.

FAQ

Yes. If your app is accessed from multiple domains, verify each one separately.
No. Staging domains do not need verification unless you want them to appear in public listings.
Verification remains valid as long as the TXT record stays in place.
Yes. Verify the new domain by completing the same process.

Next steps