Configuring a custom manifest file for Zoom Outlook add-in
Administrators can deploy the Zoom for Outlook add-in using either the Microsoft Entra application gallery or a custom manifest file. This article covers the custom manifest approach, which lets you pre-configure SSO authentication and enable optional features like Zoom Phone and Workspace Reservation before deployment.
Requirements for configuring a custom manifest file
To configure and deploy a custom manifest file, you'll need:
- Account owner or admin privileges
- Admin access to the Microsoft 365 admin portal
- SSO configured for your Zoom account
- Licensed user with Zoom Phone license (if enabling Zoom Phone)
- Licensed user with Workspace Reservation license (if enabling Workspace Reservation)
Custom manifest vs. gallery deployment
Before configuring a custom manifest, consider which deployment method fits your organization's needs.
- Microsoft Entra gallery deployment is the simplest option. The add-in updates automatically, and users get access to the Automatically add Zoom Meeting setting that adds Zoom meeting details to every new Outlook calendar event by default. However, you can't pre-configure SSO or enable features like Zoom Phone calling directly from Outlook.
- Custom manifest deployment gives you more control. You can pre-configure your SSO domain so users authenticate automatically, and you can enable Zoom Phone and Workspace Reservation features in the add-in. The tradeoff: the add-in won't update automatically, and the Automatically add Zoom Meeting option isn't available. You'll need to monitor release notes and manually deploy updates to get new features and bug fixes.
| Capability | Gallery deployment | Custom manifest |
|---|
| Automatic add-in updates | enabled | disabled |
| Pre-configured SSO | disabled | enabled |
| Zoom Phone in Outlook | disabled | enabled |
| Workspace Reservation in Outlook | disabled | enabled |
| Auto-add Zoom Meeting to events | enabled | disabled |
How to download and configure the manifest file
The Zoom Download Center provides a configuration panel where you select your SSO domain and enable optional features before downloading the manifest file. The panel displays feature options based on the licenses associated with your admin account.
- Sign in to the Zoom web portal as an admin with the privilege to edit account settings.
- Go to the Zoom Download Center.
- Scroll down to Other download options.
- Under Zoom add-in for Microsoft Outlook, click Configure (Admin Only).
This option will only appear to logged in Zoom administrators with access to manifest creation. - In the Select a sign-in method dropdown, select Sign in with pre-configured SSO domain: yourcompany-domain.zoom.us.
- Select any optional features you want to enable:
- Add Zoom Phone to Outlook add-in: Allows users initiate Zoom Phone calls directly from the Outlook client. This appears in Outlook mail read mode after deployment.
- Add Zoom Workspace Reservation to Outlook add-in: Allows users book Zoom Rooms-equipped meeting spaces while creating calendar events. This appears in Outlook calendar compose mode after deployment.
- Click Download Manifest File.
You can enable both Zoom Phone and Workspace Reservation in the same manifest file if your account has both licenses.
How to deploy the manifest file
After downloading your configured manifest file, deploy it through the Microsoft 365 admin portal. During deployment, you'll choose how the add-in is assigned to users. These are the same options available for gallery deployments:
- Optional, enabled by default: The add-in is added for all assigned users, but they can remove it.
- Optional, disabled by default: Users can add the add-in themselves, but it won't appear by default.
- Mandatory: The add-in is added for all assigned users and can't be removed.
To deploy the manifest:
- Sign in to the Microsoft 365 admin portal.
- Go to Settings then click Integrated apps.
- Click Upload custom app.
- Under Upload Apps to deploy, select Office Add-in as the app type.
- Under Choose how to upload app, select Upload manifest file (.xml) from device and select your downloaded manifest file, or select Provide link to manifest file if you're hosting the file at an accessible URL.
- Follow the deployment wizard to assign users or groups and select your deployment option.
- Review your selections and complete the deployment.
The add-in typically becomes available to assigned users within a few hours, though it can take up to 72 hours to propagate across all Outlook clients.
How to update the manifest file
Because custom manifest deployments don't receive automatic updates, you'll need to periodically download a new manifest and update your deployment to get the latest features and fixes.
- Sign in to the Microsoft 365 admin portal.
- Go to Settings then click Integrated apps.
- Click Zoom to open the add-in details.
- Click Update add-in.
- Under Choose how to upload the add-in, select I have the manifest file (.xml) on this device.
- Select your new manifest file and click Update.
Your updated add-in will deploy to users following the same 72-hour propagation timeline as new deployments.