Connect a custom domain
Connect your domain, configure DNS at your provider, and check HTTPS readiness.
You need a paid workspace plan, an Owner or Admin role, and access to your domain's DNS settings. Publish the project first so it has a live website to connect.
Add the domain in Reforma
- Open the project in the editor and select the project name in the header.
- Select Settings, then Domains.
- Select Add custom domain.
- Enter the hostname, such as
www.example.com, withouthttps://or a page path. - Select Add custom domain again.
Reforma opens Complete setup for your hostname, with a table of Type, Host, and Value records.
If Reforma does not accept a root domain such as example.com, use the suggested subdomain, such as www.example.com.
Add the DNS records at your provider
- Sign in to the service that manages DNS for your domain and open its DNS records. This may be your registrar or another DNS provider.
- Add or update each record shown in Reforma, using its record type, full hostname, and value.
- Follow any instruction shown to disable proxying for a record.
- Save the records at your DNS provider.
- Return to Reforma and select I've added the records to close the setup instructions.
- In the domain's row, select Check status to check the connection.
I've added the records only closes the instructions. Use Check status to verify your DNS changes.
Check the full record name
DNS providers interpret the Host field differently. Check the full hostname your provider creates from it.
For a record intended for www.example.com, your DNS provider may require Host to be www. If it manages example.com, entering @ usually creates a record for example.com, even if Reforma uses @ to mean the connected hostname. Check that the resulting name is www.example.com, without the domain repeated twice.
Wait for DNS and HTTPS
Stay in Settings → Domains to check the domain's status. You can reopen its instructions using DNS records and refresh with Check status.
| Status | What to do |
|---|---|
| Pending DNS changes | Check the record names, types, and values at your DNS provider. Allow time for DNS changes to become visible, then check again. |
| Waiting for HTTPS | DNS setup is progressing, but HTTPS is not ready yet. Wait and check again. |
| Live | Open the hostname and confirm the published website loads over HTTPS. |
| Error | Hover over the status to read the error, resolve the reported problem, then use Check status. |
| Needs a paid plan | Restore a paid workspace plan before using the custom domain. |
Reforma also checks pending domains automatically. DNS changes and HTTPS setup can take time; check the status again if the domain is not ready.
If adding the domain reported an error but left a row in the list, correct the problem and use Check status on that row instead of adding it again.
Replace or remove a domain
To replace an address, add the new domain and wait for Live before removing the old one.
- From the project-name menu, open Settings → Domains.
- On the domain you want to disconnect, select Remove.
- In Remove domain, select Remove to confirm.
Removing means disconnection is still in progress. Removing the domain from Reforma does not cancel its registration or edit records at your DNS provider. Update those records separately when needed.