This article answers common questions about configuring and using a custom domain.

• Custom Domains

Question: What is a custom domain as it relates to Auth0 and how is this different from <subdomain>.auth0.com?

Answer: Auth0 allows for the configuration of a custom domain on authentication pages. This allows a more unified login experience for users. A custom domain is different from the default tenant domain in that it can be displayed to users instead of a canonical auth0 domain. For example, <subdomain>.auth0.com vs. login.custom_domain.com. Some more information on custom domains and their benefits in the Custom Domains docs.

Question: How can a custom domain be configured?

Answer: A custom domain can be configured in a few straightforward steps - All of which are outlined in the Auth0 Managed Certificates docs.

Question: Why is the custom domain directing users to a site rather than initiating the login flow?

Answer: Most OAuth/OIDC login flows should begin with a request to the /authorize endpoint. This is typically managed by our SDKs - Otherwise this request will need to be formed manually.

Question: Is it possible to change the custom domain currently configured in a tenant?

Answer: If a custom domain is configured for a tenant and needs to be changed, first, the current configuration needs to be deleted and then the new one can be configured. Keep in mind this could lead to downtime in certain applications. It is recommend moving to a canonical (<subdomain>.auth0.com) in order to mitigate potential issues during the transition to a new custom domain.

Question: Can a canonical domain be used once a custom domain has been configured?

Answer: Yes - canonical domains (<subdomain>.auth0.com) can be used once a custom domain has been configured. Custom domains have no effect on it.

Question: Is it possible to configure multiple custom domains for the same tenant?

Answer: Yes, please read more about Multiple Custom Domains.

Considerations:

• Custom domains must be configured with an appropriate subdomain such as login.<subdomain>.com or auth.<subdomain>.com, etc.
• Self-managed certificates are only available for Auth0 Enterprise customers.

Related References

• Configure Features to Use Custom Domains
• Troubleshoot Custom Domains
• Custom Domains and Cross-Origin Authentication