Agiled Docs

Custom domains let a workspace use branded public URLs.

Workspace Subdomain

Every workspace has a built-in workspace host. The Domains page shows this host as read-only because workspace subdomains are fixed after creation.

Keep the built-in workspace URL available even after adding a custom domain. It is useful for troubleshooting and gives your team a reliable fallback if DNS for the custom domain is being changed.

Add A Custom Domain

Open Settings → Domains.
Enter the branded host, such as portal.example.com.
Select Save domain.
Copy the DNS record name and value shown by Agiled.
Add the record at your DNS provider.
Return to Agiled and select Verify DNS.
Wait for the domain status to become active.

Only owners and admins can manage domains. If the inputs are disabled, check your permissions and whether the domain feature is enabled for the environment.

Use a subdomain for workspace public pages, such as portal.example.com or clients.example.com. Avoid pointing a root marketing domain at Agiled unless your DNS and website plan explicitly call for that.

DNS Records

Agiled shows the DNS records that must be created for the domain. Copy the name and value exactly. Small differences such as an extra root domain, missing subdomain, or wrong target value can prevent verification.

For most custom hosts, you create a CNAME record from the branded host to the target Agiled provides.

If your DNS provider has proxy or CDN options, confirm whether Agiled expects the record to be proxied or DNS-only. A proxy setting can hide the target value Agiled is trying to verify.

Provider references:

Verify DNS

Use Verify DNS after the DNS record exists at your provider. The page shows a status for each record:

Pending means Agiled has not verified the record yet.
Verified means the record was found and matches.
Failed means the record is missing or does not match what Agiled expects.

The page also shows when the custom domain was last checked and when it was verified.

After verification, open the custom domain in a private browser window and test one public page. DNS verification confirms routing, but a public-page test confirms customers can actually load the branded URL.

Remove A Domain

Open Settings → Domains.
Confirm the custom domain shown on the page is the one you want to remove.
Select Remove domain.
Remove the DNS record at your DNS provider if it is no longer needed.

Removing a custom domain does not remove the built-in workspace host.

Status And Redirects

The Domains page shows the canonical host and custom domain status. When a custom domain is active, public workspace URLs can use the branded host. If workspace redirect is enabled, traffic can be directed toward the canonical host.

Troubleshooting

DNS changes can take time to propagate. If verification fails, check the exact record name, value, proxy status, and whether the domain is managed in the expected DNS account.

Also check:

the domain was entered without http:// or https://;
the record was added to the authoritative DNS provider;
the DNS record type matches Agiled's instruction;
the CNAME target was copied exactly;
the provider is not flattening or proxying the record in a way that hides the expected value;
enough time has passed for DNS propagation.

Domains

On this page