Overview
This article details how to set up a Custom Domain with a Squarespace domain.
Please note: the example domain used in this post is not a real website.
Applies To
- Custom Domain
Solution
Let’s break down the domain: <subdomain>.<domain>.com/<path>
- Subdomain: goes before the domain
- Domain: acquired on the domain provider, in this case Squarespace
- Path: goes after the domain
For this article, an auth subdomain or path is required, which is where the app will be routed to when users need to sign up or login. Here are some examples of what it could look like if the domain is coolest-startup-ever.com
- Subdomain:
auth.coolest-startup-ever.com(this one will be used in this knowledge article) - Subdomain:
login.coolest-startup-ever.com - Path:
coolest-startup-ever.com/auth - Path:
coolest-startup-ever.com/login
Squarespace
Add the custom domain in Auth0
- Log into Auth0 and navigate to the Tenant Settings
- Click on the Custom Domains tab
- Under Domain, add the subdomain or path (
auth.coolest-startup-ever.com) - Under Certificate Type, select Auth0-managed certificates
- Click Add Domain
Add CNAME to the domain provider (Squarespace in this case)
- Head to the Domains page in the domain provider
- Click on the domain to add to Auth0 and head to the DNS Settings
- For new domains, remove the default record from the domain provider
- Create a CNAME
- Setup the values correctly
- Host = subdomain (auth)
- Type =
CNAME - Data = CNAME Content (Auth0)
- Host should just be just the subdomain by itself e.g.
authinstead ofauth.coolest-startup-ever.com
For more details, refer to CNAME on DNS records for web hosting on the Squarespace Help Center.
Note: Squarespace does not allow for using @ as the Host for using the “pure” domain as the auth0 tenant domain
Once these steps are completed, the process to verify the domain can take between 10 - 30 minutes. If the following error is encountered, please wait and try again after 30 minutes.
