Deploy Office Add-ins in Government Community Cloud High (GCC High) environments

Deploy Office Add-ins in Government Community Cloud High (GCC High) by using centralized deployment in the Microsoft 365 admin center. This article explains two deployment options so you can deploy add-ins when Marketplace access isn't available.

Deploy an Office Add-in using the manifest XML URL

First try to deploy the add-in using the manifest XML URL. If the steps in this section fail, follow the steps in the next section Deploy an Office Add-in using the manifest XML file.

To deploy an Office Add-in using the manifest XML URL, follow these steps:

  1. In your browser, go to the Microsoft Marketplace.

  2. Search for and then select the tile of the add-in you want to deploy. Make sure to select the tile and not the Get it now button. The details page opens for the add-in.

  3. In the URL for the details page, find and copy the AssetID value. The AssetID value is the value at the end of the URL:

    https://marketplace.microsoft.com/<locale>/product/<AssetID>

    For example, in the URL:

    https://marketplace.microsoft.com/en-us/product/WA1234567989

    The AssetID value is:

    WA1234567989

  4. Paste the AssetID value to the following URL:

    https://store.office.com/app/download?assetid=<AssetID>

    For example, using the example AssetID value of WA1234567989 from the previous step, the URL is:

    https://store.office.com/app/download?assetid=WA1234567989

    If you go to this URL, it displays the manifest XML for the add-in.

  5. In a new browser window or tab, sign in to the Microsoft 365 admin center.

  6. From the left navigation bar, select … Show all, and then select Settings to expand it.

  7. Under Settings, select Integrated apps.

  8. In the Integrated apps page, make sure the Deployed apps tab is selected, and then select Upload custom apps.

  9. In the Upload Apps to deploy page of the Deploy New App pane:

    1. In the App type dropdown menu, select Office Add-in.

    2. Under Choose how to upload app, select Provide link to manifest file, copy and paste the manifest XML URL previously determined into the text box, and then select Validate.

  10. Once the manifest XML file is validated, the message Manifest file validated appears. Select Next.

  11. In the Add users page of the Deploy New App pane, under Assign users select the users you want to have access to the add-in, and then select Next.

  12. In the Accept permissions requests page of the Deploy New App pane, review the permissions that the add-in is requesting. If you accept the permissions, select Next.

  13. In the Review and finish deployment page of the Deploy New App pane, review the deployment settings, and then select Finish Deployment.

  14. When the deployment completes, the message Deployment completed appears. Select Done.

Deploy an Office Add-in using the manifest XML file

If the deployment of the add-in using the manifest XML URL fails, use the steps in this section instead.

To deploy an Office Add-in using the manifest XML file, follow these steps:

  1. In your browser, go to the Microsoft Marketplace.

  2. Search for and then select the tile of the add-in you want to deploy. Make sure to select the tile and not the Get it now button. The details page opens for the add-in.

  3. In the URL for the details page, find and copy the AssetID value. The AssetID value is the value at the end of the URL:

    https://marketplace.microsoft.com/<locale>/product/<AssetID>

    For example, in the URL:

    https://marketplace.microsoft.com/en-us/product/WA1234567989

    The AssetID value is:

    WA1234567989

  4. Paste the AssetID value to the following URL:

    https://store.office.com/app/download?assetid=<AssetID>

    For example, using the example AssetID value of WA1234567989 from the previous step, the URL is:

    https://store.office.com/app/download?assetid=WA1234567989

  5. In a new browser window or tab, go to the URL determined in the previous step. The page at this URL displays the manifest XML for the add-in.

  6. Right-click on the page, select Save As or Save Page As (depending on your browser), and then save the manifest XML file to a known location on your device. Make sure the file is saved as an .xml file with the .xml extension.

  7. In a new browser window or tab, sign in to the Microsoft 365 admin center.

  8. From the left navigation bar, select … Show all, and then select Settings to expand it.

  9. Under Settings, select Integrated apps.

  10. In the Integrated apps page, select Upload custom apps.

  11. In the Upload Apps to deploy page of the Deploy New App pane:

    1. In the App type dropdown menu, select Office Add-in.

    2. Under Choose how to upload app, select Upload manifest file (.xml) from device and then select Choose File.

    3. Browse to the location where you saved the manifest XML file, select the file, and then select Open.

  12. Once the manifest XML file is validated, the message Manifest file validated appears. Select Next.

  13. In the Add users page of the Deploy New App pane, under Assign users select the users you want to have access to the add-in, and then select Next.

  14. In the Accept permissions requests page of the Deploy New App pane, review the permissions that the add-in is requesting. If you accept the permissions, select Next.

  15. In the Review and finish deployment page of the Deploy New App pane, review the deployment settings, and then select Finish Deployment.

  16. When the deployment completes, the message Deployment completed appears. Select Done.

Important

If there's an error concerning Admin Consent, the add-in isn't GCC High compatible. The Developer of the add-in should be contacted to allow their add-in to be GCC High compliant.

  • Last updated on