Move App Service resources to a new resource group or subscription

  • Article

This article describes the steps to move App Service resources between resource groups or Azure subscriptions. There are specific requirements for moving App Service resources to a new subscription. Unless otherwise noted, these steps apply to both App Service Web Apps and Azure Functions.

Move across subscriptions

When you move an app across subscriptions, the following guidance applies:

  • Moving a resource to a new resource group or subscription is a metadata change that shouldn't affect anything about how the resource functions. For example, the inbound IP address for an app service doesn't change when moving the app service.
  • The destination resource group must not have any existing App Service resources. App Service resources include:
    • Web apps
    • App Service plans
    • Uploaded or imported TLS/SSL certificates
    • App Service Environments
  • All App Service resources in the resource group must be moved together.
  • App Service Environments can't be moved to a new resource group or subscription.
    • You can move an app and plan hosted on an App Service Environment to a new subscription without moving the App Service Environment. The app and plan that you move are always associated with your initial App Service Environment. You can't move an app/plan to a different App Service Environment.
    • If you need to move an app and plan to a new App Service Environment, you'll need to recreate these resources in your new App Service Environment. Consider using the backup and restore feature as way of recreating your resources in a different App Service Environment.
  • Apps with private endpoints cannot be moved. Delete the private endpoint(s) and recreate it after the move.
  • Apps with virtual network integration can't be moved. Remove the virtual network integration and reconnect it after the move.
  • App Service resources can only be moved from the resource group in which they were originally created. If an App Service resource is no longer in its original resource group, move it back to its original resource group. Then, move the resource across subscriptions. For help with finding the original resource group, see the next section.

Move hidden resource types in portal

When using the portal to move your App Service resources, you may see an error indicating that you haven't moved all of the resources. If you see this error, check if there are resource types that the portal didn't display. Select Show hidden types. Then, select all of the resources to move.

Screenshot of the Show Hidden Types option in the portal when moving App Service resources.

Move with free managed certificates

You can't move a free App Service managed certificate. Instead, delete the managed certificate and recreate it after moving the web app. To get instructions for deleting the certificate, use the Migration Operations tool.

If your free App Service managed certificate gets created in an unexpected resource group, try moving the app service plan back to its original resource group. Then, recreate the free managed certificate. This issue will be fixed.

Move support

To determine which App Service resources can be moved, see move support status for:

Next steps

For commands to move resources, see Move resources to new resource group or subscription.