Custom Domain Redirects to Base Domain

Last Updated: Aug 9, 2024

Overview

When visiting the custom domain directly, it will redirect to the base Auth0 canonical domain. This article explains why this does not redirect to the default login route and clarifies whether there is a way to change this.

Applies To

  • Custom Domain
  • Redirect
  • Base domain

Solution

This behavior is expected.

  • Note that enabling a Custom Domain does not mean that it will replace the Canonical (old) Domain. Instead, both the Canonical Domain and the Custom Domain can be used.
    • To use the Custom Domain, it should be added to the application configuration to be implemented in the correct context.
  • As the Custom Domain replaces Auth0’s Canonical Domain, navigating directly to it will not work.
    • Auth0 domains are an entry door for Auth0’s APIs. Any action performed with Auth0 should be done by calling the correct endpoint.
    • For example, when initiating a login flow, the /authorize endpoint should be used. When retrieving users from the management API, the api/v2/users endpoint is called.

Calling the Custom Domain without specifying any endpoint will result in a redirection to the base URL bceause Auth0 does not know what action should be taken and defaults to the base domain.