Domains with non ascii / "xn--" characters in the name

Get Help
,
1

I need to create a tenant for a domain with the Danish character “ø” in the name.

It becomes:

xn–[something]-54a

But the portal refuses to create a tenant with a name starting with “xn–”.

Is there a workaround?

3

Hi @anders6,

Welcome to the Auth0 Community!

Currently, Auth0 tenant names must be alphanumeric and can contain hyphens, but they cannot start or end with a hyphen. Because Internationalized Domain Names use the “Punycode” prefix xn--, they are currently blocked by the Dashboard’s validation logic.

Since you cannot use the Punycode version as the actual tenant name, the standard industry recommendation is to use a Custom Domain.

  1. Create a standard tenant name: Create your Auth0 tenant using a simplified, ASCII-only version of your name (e.g., brand-denmark or brand-dk).
  2. Configure a Custom Domain: Once the tenant is created, go to Settings > Custom Domains in your Auth0 Dashboard.
  3. Use your Internationalized Domain Name: You can map your actual domain (e.g., login.your-dømain.dk) to Auth0. Our Edge network and TLS providers support IDN/Punycode at the custom domain layer, even if the underlying tenant name is simple ASCII.
  4. Update your Application: Once configured, your users will only see login.your-dømain.dk in the browser bar, and the underlying xn-- tenant name remains a hidden technical detail.

If you have any further questions, please don’t hesitate to reach out.

Have a good one,
Vlad

1 Like