Skip to main content

How to Deploy an Office Add-In via the Admin Center

K
Written by Kay Chen

This article provides a step-by-step walkthrough for deploying an Office Add-in via the admin center.

Please note that Add-Ins are only supported by supported versions of Microsoft 365 to guarantee uninterrupted collaboration and data safety. For more information on the supported versions, please refer to the following article: https://help.certara.ai/en/articles/9971899-coauthor-compatibility-ensuring-seamless-collaboration-with-supported-microsoft-365-versions

To install and manage Office add-ins in Microsoft 365, specific roles are required depending on whether you're an administrator or a user:

🔐 Administrator Roles

These roles allow admins to install and manage add-ins for the entire organization:

  • Org Marketplace Apps: Enables installation and management of add-ins from the Office Store.

  • Org Custom Apps: Enables installation and management of custom add-ins.

These roles are typically assigned to members of the Organization Management role group by default.

👤 User Roles

These roles allow individual users to install and manage add-ins for their own use:

  • My Marketplace Apps: Install and manage Office Store add-ins.

  • My Custom Apps: Install and manage custom add-ins.

  • My ReadWriteMailbox Apps: Install and manage add-ins that require ReadWriteMailbox permissions.

By default, most end users have these roles enabled unless restricted by policy.

✅ Additional Consideration

Ensure that the AppsForOfficeEnabled parameter is set to True in your organization’s configuration. If it's set to False, it overrides all role settings and prevents any add-ins from being activated

Check Permissions

To check user permissions in the Microsoft 365 admin center, follow these steps:

  1. Sign in to admin.microsoft.com using your admin credentials.

  2. In the left-hand navigation pane, go to Users > Active users.

  3. Select the user whose permissions you want to check.

  4. In the user's details pane, look for the Roles section.

  5. Click Manage roles to view or change the admin roles assigned to the user.

If you want to see what each role allows a user to do:

  1. Go to Roles > Role assignments in the admin center.

  2. Select a specific role to open its detail pane.

  3. Click the Permissions tab to see what actions users with that role can perform

Deploying an Office Add-in via the Microsoft 365 Admin Center

To deploy an Office Add-in through the Admin Center, follow these steps:

  1. Browse to admin.microsoft.com and click on Settings --> Integrated Apps --> Upload custom apps

  2. Choose Office Add-in, select Provide Link to the manifest file*, paste the file and click Validate, then click Next

  3. Choose yes or no for test deployment, select Entire Organization to deploy to all users or choose Specific users/groups, then click Next

  4. Review permissions, then click Next

Click Finish Deployment

Did this answer your question?