Change domain or subdomain

Learn how to change your production instance's domain or subdomain on Clerk.

Change domain

Production domains can be changed in the Clerk Dashboard or via our backend API.Once you make the change to your domain you will need to update the following:

Update the publishable key
Update DNS records
Generate new SSL certificates
If using social connections, update redirect URLs for enabled social connections
If using JWT templates, update JWT issuer and JWKS endpoint in external JWT SSO services

Clerk Dashboard

To update the production URL from the dashboard, go to the DNS section and select Change domain. You will receive a prompt to enter your new production domain.

Image showing the prompt to update production URL

Update via backend API

You can copy the following cURL making sure the correct secret and home url is set.

.env1

Reference URL: https://clerk.com/docs/reference/backend-api/tag/Beta-Features#operation/ChangeProductionInstanceDomain

Specify Subdomain

If you would like to specify your subdomain of your application for example `app.clerk.com` you can do this from the Paths section of the Clerk dashboard.

Image showing the prompt to change your subdomain