Skip to main content
The easiest way to use a custom domain is through the Composite dashboard. You simply add DNS records to point your subdomain to Composite’s servers - no proxy infrastructure required.
1

Open Custom Domain Settings

Go to your Composite Dashboard and navigate to Settings → Custom Domain.Choose between Custom Domain (subdomain) or Subpath Proxy based on your needs.
Custom domain configuration in Composite dashboard
2

Enter Your Subdomain

Enter your desired subdomain (e.g., analytics.yourcompany.com) and click Set Domain.The dashboard will generate the DNS records you need to add.
3

Add DNS Records

Add the following records to your DNS provider:
DNS records for custom domain verification
1. TXT Record (Verification)
FieldValue
TypeTXT
Name_composite-verify.analytics.yourcompany.com
Valuecomposite-domain-verify=<your-verification-code>
2. CNAME Record (Routing)
FieldValue
TypeCNAME
Nameanalytics.yourcompany.com
Targetprod.alb.us.api.composite.com
DNS changes typically propagate within minutes, but can take up to 48 hours in rare cases.
4

Verify Domain

Click Verify Domain in the dashboard. Once verified, your custom domain is ready to use.
5

Configure Your SDK

Update your extension to use your custom domain:
await composite.init({
  apiKey: 'pk_your_api_key',
  apiHost: 'https://analytics.yourcompany.com',
  transport: 'chrome-extension'
});
Update your manifest to only require your domain:
"host_permissions": [
  "https://analytics.yourcompany.com/*"
]

​
Troubleshooting

Check that:
  1. The TXT record name matches exactly what’s shown in the dashboard
  2. DNS has propagated (use dnschecker.org to verify)
  3. There are no typos in the verification value
Verify:
  1. The CNAME record is pointing to prod.alb.us.api.composite.com
  2. Your SDK’s apiHost matches your custom domain exactly
  3. Your manifest includes the custom domain in host_permissions

​
What’s Next?

Background Script

Configure the background service worker

Content Script

Set up session recording