Auth0 prevents tenant name changes after creation to maintain unique tenant names, which restricts modifications to the canonical domain. To use a different domain name, configure a custom domain and update applications to route authorization requests to the new custom domain.

• Auth0
• Tenant Configuration
• Canonical Domains
• Custom Domains

Auth0 does not allow changes to the tenant name after creation because tenant names must remain unique. This restriction directly affects the canonical domain. Auth0 creates the canonical domain using the following format: https://<tenant_name>.<region>.auth0.com.

For example, if the tenant name is <company_name_prod> and the region is the US, the canonical domain is https://<company_name_prod>.us.auth0.com. Because the canonical domain relies on the tenant name, Auth0 prevents modifications to the canonical domain.

What steps configure a custom domain to replace the canonical domain?

Configure a custom domain and update the application configuration to route authorization requests to the new domain.

1. Configure a custom domain (for example, https://auth.<company_name>.com).
2. Update the application's configuration file to make the /authorize request to the custom domain instead of the canonical domain.

Related References

• Custom Domains