Connect a domain

Who can use this: Custom domains are included on paid plans, not on Free. Needs permission to manage domains.

Serve your site from your own domain instead of its free address.

Before you start

You need access to your domain's DNS settings at your registrar or DNS provider.

Add the domain

1. Open Site Settings, then Domains.

2. Click Add, enter the domain (for example www.example.com or example.com), and confirm.

The domain appears with its DNS setup records.

Add the DNS records

Copy each record from the DNS setup panel to your DNS provider. Use the exact Host and Value shown.

• TXT: proves you own the domain. Always required.

• CNAME: connects a subdomain such as www.

• A: connects a root domain such as example.com. A root domain cannot use a CNAME record.

For a root domain, adding the www CNAME as well is recommended so both addresses reach your site. Some providers also offer ALIAS, ANAME or CNAME flattening at the root; those work too.

A registrar's URL forwarding does not connect a domain. Only real DNS records work.

Verify the domain

1. After adding the records, click Verify next to the domain. DNS changes can take time to reach the internet, so try again later if it fails.

2. When verification succeeds, the domain shows Verified, and an SSL certificate is requested automatically.

Choose the primary domain

Click Set as primary on a verified domain to make it your site's main address.

Manage SSL

Each domain has an SSL mode:

• Managed by Praisma: the certificate is issued and renewed for you. Use Retry Issue if issuing fails and Force Renew to renew now.

• Bring your own cert: click Upload SSL and paste your Certificate PEM and Private Key PEM.

Check SSL refreshes the status. The status moves through Pending DNS verification, SSL pending and Active. Expiring soon, Expired and Failed need action.

Set a language or variant for a domain

If your site has several languages, use Locale override to serve one domain in a fixed language, then click Save targeting.

Troubleshooting

• Domain is not connected to the Praisma platform yet. The CNAME or A record is missing or has not reached the internet yet. Check the records and try again.

• www is connected, but the root domain is not. You added www at your provider but not the root. Add the domain you connected, or connect the root as well.

• Domain is already assigned to another tenant. The domain is in use by a different workspace. Remove it there first.

• Domain verification failed. The TXT record is missing or incorrect. Copy it again from DNS setup.

Related

• Publish, versions and redirects

• Languages

• SEO