How to configure custom domain on Intercom
Configure a custom domain on Intercom by accessing Settings > Workspace > Custom Domain, entering your domain details, and updating your DNS records with the provided CNAME values. Verify the setup and enable SSL to complete the configuration.
Prerequisites
- Active Intercom account with admin access
- Custom domain ownership and DNS management access
- SSL certificate for your domain
- Basic understanding of DNS records
Step-by-Step Instructions
Access Custom Domain Settings
Enter Your Custom Domain
help.yourcompany.com) in the domain field and click Add Domain.Configure DNS Records
- Name/Host: Your subdomain (e.g., help)
- Value/Points to: The CNAME value from Intercom
- TTL: 300 seconds (or lowest available)
Verify Domain Configuration
Enable SSL Certificate
Update Help Center Settings
Test Your Custom Domain
https://help.yourcompany.com) to verify it's working correctly. Check that all pages load properly and the SSL certificate shows as secure in your browser.Common Issues & Troubleshooting
Domain verification fails after adding DNS records
Check that your CNAME record exactly matches the value provided by Intercom. Remove any trailing dots and ensure there are no extra spaces. Wait 30 minutes and try verification again.
SSL certificate won't enable or shows as failed
Ensure your domain is fully verified first. Check that your DNS records are propagated using a tool like dig or online DNS checkers. Contact your DNS provider if records aren't updating.
Custom domain shows 'Not Found' or 404 error
Verify that your Help Center is published and the custom domain is selected in Help Center settings. Check that the CNAME points to the correct Intercom endpoint.
Mixed content warnings on custom domain
Ensure all embedded content (images, scripts) uses HTTPS URLs. Check your Help Center customizations and remove any HTTP references in custom CSS or JavaScript.