Custom domains

Org settings → Domains lets organization administrators serve Athean links from their company's own subdomains, such as docs.yourcompany.com, instead of Athean's addresses. The page is in the Integrations group of Org settings, and only organization administrators can open it.

A custom domain can be assigned to two uses:

The page has two parts. Domain assignments shows the address each use has now, marked Custom domain or Athean-provided, with an example link. Your domains lists the subdomains you've connected, with each one's status and uses.

• Connecting a domain changes no links. A connected domain serves nothing until you assign it to a use.
• Each use has one address. One connected domain can serve both uses. Changing one use doesn't change the other.
• Athean-provided links keep working. After you assign a custom domain, links on your Athean document address and on app.athean.com still open.
• Some share links always use Athean's address. Share links for Presentations and Custom dashboards don't use custom domains.

Connecting a subdomain means adding two DNS records for it, so you need access to your company's DNS settings or someone in IT who can add records.

1. Open Org settings → Domains. Under Your domains, select Add domain.
2. In Subdomain, enter the address you want to use, such as docs.yourcompany.com or meet.yourcompany.com. Enter the address only, without https:// or a path.
3. Select Continue to DNS setup. The subdomain appears under Your domains with the status Preparing DNS, and its records appear under DNS & details when they're ready. Then add the DNS records.

• Use a subdomain. docs.yourcompany.com works; a root domain such as yourcompany.com doesn't. Athean's own domains can't be connected.
• Use an address that isn't already serving another website. The Connect your address record sends all of that address's traffic to Athean.
• Each subdomain belongs to one organization. If another organization has already connected it, contact support.
• Connect as many subdomains as you need. Domains can stay connected without being assigned.

To fix a typo or abandon a setup, select Cancel setup on the domain's row (see Remove a domain). A connected domain can't be renamed: connect the new subdomain, assign it, and then remove the old one.

1. In Org settings → Domains, select DNS & details on the domain's row.
2. With your DNS provider, add the two CNAME records listed under DNS records:
   • Connect your address: its name is your subdomain, and its value is the address shown in DNS & details. This record sends the subdomain's traffic to Athean.
   • Enable HTTPS: lets Athean get the certificate that secures the subdomain. Its name and value are also shown in DNS & details.
   Use the copy button beside each Name and Value so the records match exactly. To hand the work to IT, select Copy for IT, which copies both records with setup instructions.
3. Use the default TTL, and turn off proxying (DNS only) for both records. If your provider adds your domain to record names automatically, leave that suffix out of the name you enter.
4. Wait for both records to show Verified and the domain to show Connected. The status updates automatically; select Check status to ask Athean to check now. DNS can take up to 48 hours, followed by a few minutes for HTTPS.

Keep both records in place for as long as you use the domain. Athean needs them to serve the domain and to renew its HTTPS certificate. Connecting doesn't assign the domain: when it shows Connected, assign it to a use.

DNS & details also shows the latest message about the setup and when Athean last checked it.

1. In Org settings → Domains, under Domain assignments, find Document hosting or Meeting scheduling. Select Assign domain, or Change if a custom domain is already assigned.
2. In Domain for document hosting or Domain for meeting scheduling, choose a connected domain. The Athean-provided address is also in the list. Domains that aren't ready for that use are listed but can't be chosen.
3. Select Save assignment.
4. Read the confirmation, which names the new address and any links that will stop working, then select Change domain.

To return a use to its Athean-provided address, select Unassign beside it, then select Unassign domain in the confirmation. The custom domain stays connected and can be assigned again.

Only a domain with the status Connected can be assigned. A domain that shows This connection supports documents only can be used only for document hosting; to use it for meeting scheduling, contact support.

What each change does to links

Athean doesn't rewrite links in emails that were already sent, in saved drafts, or in scheduled messages that were already prepared. A link added to an email with Insert scheduling link keeps the address it had when you added it. The Sender Scheduling Link variable in sequence templates and snippets uses the current address each time a message is prepared. The Hosted page card in Knowledge corpus and the booking URL in Settings → Scheduling link always show the current address.

Before you change or unassign a custom domain, update the links you've shared on it. Assigning that domain to the same use again makes its links work again.

You can remove a domain only when it isn't assigned to either use. If it's assigned, its row says which uses to unassign or change first.

1. In Org settings → Domains, under Your domains, select Remove domain on the domain's row. For a setup that isn't finished, the button is Cancel setup.
2. In the confirmation, select Remove domain. The domain shows Disconnecting while Athean removes its hosting connection, and then it leaves the list.
3. After removal finishes, delete both of the domain's DNS records at your DNS provider.

Removing a domain doesn't change your document or scheduling addresses. You can connect the same subdomain again after removal finishes. Use the records shown for the new setup, because the Connect your address value changes.

A domain marked Managed by Athean was set up by Athean and can't be removed from this page. To remove it, contact support.