WorkOS Docs Homepage
Custom Domains
API referenceDashboardSign In

AuthKit Domain

Guidance on configuring a custom domain for AuthKit.

Configuring a domain

The domain for AuthKit will consist of a randomly generated phrase plus the domain authkit.app, for instance youthful-ginger-43.authkit.app.

This is the default in the staging environment, in Production environments a custom domain can be configured via the dashboard.

1Navigate to Domains configuration

With the production environment selected, navigate to the Domains section of the WorkOS Dashboard.

Dashboard displaying domain configuration settings

2Add an AuthKit domain

Click the Configure AuthKit domain button and enter the domain you would like to use.

Dashboard displaying a domain entry input

3Create CNAME records

You will be prompted to add a CNAME record to your DNS provider. If your DNS provider is Cloudflare, create the CNAME record as DNS-only. Once the domain is verified, you can proxy it through your own Cloudflare zone.

Dashboard displaying CNAME entries

It can take some time for DNS changes to take effect. If the initial verification attempt is not successful, WorkOS will continue trying to verify your domain for 72 hours.

Once your domain is successfully verified, users signing in via AuthKit will be redirected to your custom domain.

Admin Portal Domain Guidance on configuring a custom domains for the Admin Portal
Up next