Custom Domain
Connect a domain you already own to your published CodeWords app using the in-product custom domain flow.
Use a custom domain so your app is available at something like app.yourbrand.com instead of only *.codewords.run.
Custom domains are a paid feature. You need an active Pro, Business, or custom plan to connect one. If you are on the Free plan, subscribe to a CodeWords plan first. See Plans and Pricing for details.
Before you start
To add a custom domain you need:
An active Pro, Business, or custom plan.
A published UI project. Finish building and testing in preview, then use the Publish button to go live on your default *.codewords.run URL. See Publishing for the full publish flow.
Once you are on a paid plan and the project is published, you can add a custom domain from the UI.
Connect your domain
1. Add your domain
Click Add custom domain and enter the domain you already own (for example app.mycompany.com or mycompany.com).
2. Copy the DNS record
CodeWords shows the DNS record you need to add. Keep this screen open—you will paste the same values at your domain provider.
3. Add the record at your domain provider
Go to the provider where you bought your domain (for example GoDaddy, Namecheap, or Cloudflare), open DNS settings for that domain, and add the record exactly as shown in CodeWords.
4. Verify
Back in CodeWords, click Verify. When verification succeeds, your app is live on your custom domain.
DNS propagation can take a few minutes, and in some cases up to 48 hours. If verification fails at first, wait and try again.
Typical DNS records
Your provider’s labels may differ slightly, but the record types are usually:
For a subdomain (for example app.mycompany.com):
Type:
CNAMEName:
appValue:
cname.vercel-dns.com(or the value CodeWords shows in the UI)
For a root domain (for example mycompany.com):
Type:
AName:
@Value: use the exact value shown in CodeWords for your project
Always use the record values shown in the Add custom domain flow for your app—they override any generic examples if they differ.
Automatic SSL / HTTPS
SSL is provisioned automatically once your custom domain is verified and connected. Traffic is encrypted by default. There is nothing extra to configure.
Troubleshooting
Verify failed or domain not live yet — DNS may still be propagating. Wait a few minutes and verify again; some providers take up to 48 hours.
Wrong record at your provider — Double-check type, name, and value match what CodeWords displayed before you clicked Verify.
Still on *.codewords.run only — Confirm the project is published and verification completed successfully in the custom domain UI.
Last updated
Was this helpful?