Custom domain

Use a custom domain to give your workspace a branded web address.

Once setup is complete, your team can sign in and use Diaflow from that address.

The workspace owner can:

• Set up a new custom domain

• View custom domain information

• Remove custom domain

Only the workspace owner can manage the custom domain.

Set up a new custom domain

Open Workspace settings and click Set up a Custom Domain.

GIF placeholder: Show how to open Workspace settings and click Set up a Custom Domain.

Step 1: Enter your domain

1. Enter the domain or subdomain you want to use.

2. Click Next.

Example: app.yourcompany.com

You must own the domain or have permission to create a subdomain.

GIF placeholder: Show how to enter a custom domain, review the example format, and click Next.

Step 2: Verify domain ownership

Diaflow generates a TXT record for verification:

• TXT — Name — Target

Add the TXT record in your domain provider

Go to the domain provider you use to manage your DNS settings.

For example, if you use name.com, add the TXT record with these values:

• Type = TXT

• Host = Paste the Name value from Diaflow

• Answer = Paste the Target value from Diaflow

• TTL = 300

Click Add Record to save the change.

Return to Diaflow and confirm that you updated your DNS settings.

Click Start Verification.

GIF placeholder: Show the full verification flow — copy the TXT values, add them in the domain provider, return to Diaflow, confirm the update, and click Start Verification.

If verification succeeds, Diaflow moves to the next step.

If verification fails, review your DNS record in your domain provider and try again.

Step 3: Configure your DNS

Diaflow generates two DNS records:

• CNAME — Name — Target

• ANAME — Name — Target

Add the DNS records in your domain provider

Go back to your domain provider and add both records.

For example, if you use name.com, set them up like this:

Record 1

• Type = CNAME

• Host = Paste the Name value from Diaflow, without your root domain

• Answer = Paste the Target value from Diaflow

• TTL = 300

Click Add Record to save the change.

Record 2

• Type = ANAME

• Host = Paste the Name value from Diaflow, without your root domain

• Answer = Paste the Target value from Diaflow

• TTL = 300

Click Add Record to save the change.

After you add both records, click Next in Diaflow.

GIF placeholder: Show how to add the CNAME and ANAME records, then return to Diaflow and click Next.

Step 4: Wait for activation

Diaflow checks your domain. This can take up to 30 minutes, but it usually finishes in 1 to 2 minutes.

You can click Close the window and return later to check the status.

You can view the current status in Workspace settings.

When the status shows successful, your custom domain is ready to use.

GIF placeholder: Show the status changing to successful and the custom domain opening correctly.

View custom domain information

After your custom domain is active, go to Workspace settings and click Manage Domain.

Diaflow opens a pop-up with your domain details.

GIF placeholder: Show how to open Manage Domain and review the saved domain details.

Remove a custom domain

To remove the custom domain, go to Workspace settings and click Remove domain and back to default.

Diaflow shows a confirmation pop-up.

• Confirm removes the custom domain and switches your workspace back to the default address.

• Cancel closes the pop-up without making changes.

After removal, your workspace uses the default address again.

GIF placeholder: Show how to remove the custom domain, confirm the action, and return to the default workspace address.

After removal, users can no longer sign in with the custom domain.

Need help?

• Need to update your workspace branding or web address? Go to Workspace settings.

• Need to manage access for teammates who use this workspace? Go to Users.

• Need help with domain setup or DNS records? Contact [e-mail].