Skip to content

Add migrating between resources section #127497

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions articles/static-web-apps/custom-domain.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,21 @@ You may want to migrate a custom domain currently serving a production website t

1. Once your domain is validated, you can migrate your traffic to your static web app by updating your `CNAME`, `ALIAS`, or `A` record to point to your [default host name](./apex-domain-external.md)

## Migrating domains between instances

Azure Static Web Apps only permit binding a unique domain to a single resource within a slice. Attempting to bind a domain already bound to another resource without first disassociating from the original resource will result in failure.

The slice your resource is placed in can be determined by inspecting the default URL assigned to it:

`<random-prefix>.<slice>.azurestaticapps.net`

eg. a Static Web App site with the default URL of `orange-pond-0a04b7203.2.azurestaticapps.net` has been placed in slice number 2.

If the static app you're migrating the domain from and to are both in the same slice you must either:

* Remove the domain from one instance, then add it to your new instance. This will result in some downtime.
* Delete and re-deploy the new instance until the resulting resource is placed into a slice different to the source instance.

## Next steps

Use the following links for steps on how to set up your domain based on your provider.
Expand Down