From d22a886387aec924cd5e9f56c5abfd0942393f4a Mon Sep 17 00:00:00 2001 From: Maciej Porebski Date: Mon, 11 Aug 2025 23:16:49 +0100 Subject: [PATCH 1/2] Add migrating between resources section --- articles/static-web-apps/custom-domain.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/articles/static-web-apps/custom-domain.md b/articles/static-web-apps/custom-domain.md index 4ec1f38a3e0b2..e03d0e460c6c4 100644 --- a/articles/static-web-apps/custom-domain.md +++ b/articles/static-web-apps/custom-domain.md @@ -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: + +`..azurestaticapps.net` + +eg. a Static Web App site withe 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. From 00570916d79e86242fe63c9ee99ef1aa9b7245b8 Mon Sep 17 00:00:00 2001 From: Maciej Porebski Date: Mon, 11 Aug 2025 23:19:39 +0100 Subject: [PATCH 2/2] Correct Typo Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- articles/static-web-apps/custom-domain.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/articles/static-web-apps/custom-domain.md b/articles/static-web-apps/custom-domain.md index e03d0e460c6c4..1e96ff3d43c86 100644 --- a/articles/static-web-apps/custom-domain.md +++ b/articles/static-web-apps/custom-domain.md @@ -77,7 +77,7 @@ The slice your resource is placed in can be determined by inspecting the default `..azurestaticapps.net` -eg. a Static Web App site withe the default URL of `orange-pond-0a04b7203.2.azurestaticapps.net` has been placed in slice number 2. +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: