Manage apps and add-ins in a Multi-Geo tenant

In a Multi-Geo tenant, you have an app catalog per geo location, which is something to consider if you want to deploy your apps across all geo locations.

By "app", we mean all apps that you deploy by first adding them to your tenant app catalog. All such apps are in scope of this guidance, including SharePoint Add-Ins (.app files) and SharePoint Framework apps and extensions (.sppkg files).

In a Multi-Geo tenant, you have one app catalog site per geo location, as shown in the following diagram.

World map showing app catalogs in North America and satellite locations in Europe and Asia

A consequence of this architecture is that you must deploy your app in all app catalogs if you want your app to be available for all sites, regardless of the geo location the site is hosted in.

To do this, you have two options:

  • Deploy your app manually in each of the app catalog sites.

  • Use the ALM APIs to automate the deployment of your apps. By using these APIs, you can write code that consistently deploys/upgrades your apps in all the geo locations of your Multi-Geo tenant.

See also