Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs-builder.nativelyai.com/llms.txt

Use this file to discover all available pages before exploring further.

Custom domains let you serve your published app from your own URL (e.g., app.yourcompany.com) instead of the default *.nativelyai.app subdomain.
Custom domains are available on Builder plans and above. Free plans use the default platform subdomain only.

​
Platform subdomain

Every project gets a default platform subdomain when created: 
yourproject.nativelyai.app
On supported plans, you can rename your platform subdomain. Old subdomains redirect to the new one for up to one year, giving you time to update links.

​
Connect a custom domain

1

Publish your app

Your app must be published before connecting a custom domain. See Publish your app.
2

Open domain settings

In your project, go to Settings → Domains.
3

Enter your hostname

Type the domain you want to connect — either a subdomain (app.example.com) or an apex domain (example.com).
4

Configure DNS

Builder shows the DNS records you need to add at your domain registrar. The records differ depending on whether you’re connecting a subdomain or apex domain:
Domain typeRecords
Subdomain (e.g., app.example.com)CNAME record + TXT verification record
Apex (e.g., example.com)A/AAAA records + TXT verification record
5

Wait for verification

After adding DNS records, Builder verifies ownership and provisions an SSL certificate. Status updates appear in the domains panel — no page refresh needed.
DNS changes can take up to 48 hours to propagate, though most providers update within minutes. You need access to your domain’s DNS settings to complete setup.

​
Domain limits

  • Up to 5 custom domains per environment (production, staging, dev) per project
  • Only one primary domain per environment at a time
  • Domains are scoped per environment — production and staging can have different domains

​
Domain status

Your domain moves through these states:
StatusMeaning
Pending verificationWaiting for DNS records to be detected
Certificate issuingOwnership verified, SSL certificate being provisioned
ActiveDomain is live and serving your app
ErrorVerification or certificate issue — check DNS records

​
Disconnect a domain

To remove a custom domain:
  1. Open Settings → Domains
  2. Select the domain
  3. Click Disconnect
Your app continues to be available on the default *.nativelyai.app URL.

​
Next steps

Publish your app

Make sure your app is published before connecting a domain.

Plans & credits

Check custom domain limits for your plan.