Preview

• https://clerk.com/docs/pr/ss-docs-11756/guides/development/deployment/changing-domains

What does this solve?

A customer was trying to move their production app from a root domain to a subdomain of the same root domain using the Change domain flow in the Dashboard. The guide was confusing because it didn't clearly explain what the Primary application and Secondary application options mean when the new domain is a subdomain.

This update keeps the guide focused on changing a production domain, while clarifying how the Dashboard flow works for changes like example.com --> app.example.com.

What changed

• Renames the guide from Change domain or subdomain to Change domain
• Updates the guide description and intro to focus on the production domain change flow
• Clarifies that changes like example.com --> app.example.com can be made from the Change domain flow in the Dashboard
• Explains the difference between Primary application and Secondary application when changing to a subdomain
• Adds a specific callout describing when the app belongs to the root domain versus when the subdomain is treated as its own app

Other resources

• Linear ticket.
• Bit more context here.