Change domain or subdomain

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

Change domain

1. Update your production domain using either of the following options:
   • The Clerk Dashboard
   • The Backend API
2. Once you make the change to your domain, you will need to update the following:
   • Update DNS records.
   • Generate new SSL certificates.
   • Update your Publishable Key.
   • If using social connections, update the settings with your social connections so that the redirect URL they are using is correct.
   • If using JWT templates, update JWT issuer and JWKS Endpoint in external JWT SSO services.

Update your domain via Clerk Dashboard

To update your production domain in the Clerk Dashboard:

1. In the navigation sidenav, select Domains⁠.
2. Scroll to find the Change domain setting.

Update your domain via Backend API

To update your production domain using the Backend API⁠, you will need to make a POST request to the change_domain endpoint. You will need to provide your new domain in the request body.

1. Copy the following cURL command.

3. Replace YOUR_PROD_URL with your new production domain.

curl -XPOST -H 'Authorization: YOUR_SECRET_KEY' -H "Content-type: application/json" -d '{
"home_url": "YOUR_PROD_URL"
}' 'https://api.clerk.com/v1/instance/change_domain'

For more information on how to update your instance settings using the Backend API, see the Backend API reference⁠.

Update your Publishable Key

After changing your domain, a new Publishable Key⁠ will be automatically generated for your application. You need to update your environment variables with this new key and redeploy your application.