'%3e%3cpath%20d='M8%200C12.4183%200%2016%203.58172%2016%208C16%2012.4183%2012.4183%2016%208%2016C3.58172%2016%200%2012.4183%200%208C0%203.58172%203.58172%200%208%200ZM11.6162%204.38379C11.2257%203.99337%2010.5927%203.99338%2010.2021%204.38379L8%206.58594L5.79785%204.38379C5.40732%203.99334%204.77429%203.99329%204.38379%204.38379C3.99331%204.77429%203.99335%205.40733%204.38379%205.79785L6.58594%208L4.38379%2010.2021C3.99348%2010.5927%203.99341%2011.2257%204.38379%2011.6162C4.77426%2012.0066%205.40734%2012.0065%205.79785%2011.6162L8%209.41406L10.2021%2011.6162C10.5927%2012.0066%2011.2257%2012.0067%2011.6162%2011.6162C12.0067%2011.2257%2012.0066%2010.5927%2011.6162%2010.2021L9.41406%208L11.6162%205.79785C12.0066%205.40735%2012.0066%204.77429%2011.6162%204.38379Z'%20fill='%23080E17'%20fill-opacity='0.46'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_3761_713'%3e%3crect%20width='16'%20height='16'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e)
How to Fix Unable to Publish Custom Apps in Microsoft 365
Question details
The user is unable to successfully publish custom applications and Outlook add-ins in their Microsoft 365 tenant.
- Product
- Microsoft 365
- Device & OS
- not provided
- Scenario
- Deploying custom apps, Outlook add-ins, or XML manifests via Centralized Deployment in a Microsoft 365 tenant with hybrid Exchange and directory synchronization.
- Observed behavior
- The deployment process fails at the final step for both XML manifests and URL-based applications across the entire organization.
Ensure you have Global Administrator or Exchange Administrator privileges in your Microsoft 365 tenant and verify that your Azure AD directory synchronization is currently healthy.
Verify Centralized Deployment Requirements and Re-upload
Ensure your hybrid tenant configuration meets Microsoft's strict requirements for centralized add-in deployment and attempt a clean manifest upload.
In hybrid environments with Azure AD synchronization, centralized deployment requires specific Exchange server configurations and OAuth authentication setups. If any of these prerequisites are missing, the deployment will fail at the final stage.
Before uploading, use the Microsoft Office Add-in validator tool to ensure your custom app's XML manifest file contains no structural errors or missing tags.
Log in to the Microsoft 365 admin center, expand the left navigation menu, and go to Settings > Integrated Apps.
Click on 'Upload custom apps', select your validated XML manifest or provide the URL, and assign it to the intended users or the entire organization.
Proceed through the deployment wizard and click 'Deploy'. If centralized deployment is enabled and hybrid requirements are met, the app should publish successfully.
Check Service Health and Open a Support Ticket
If your tenant meets all requirements but deployments continue to fail, the issue may be related to backend service health or complex directory synchronization errors.
Looking for a Lightweight Office Suite? Try WPS Office
While managing Microsoft 365 enterprise deployments can be highly complex and reliant on backend configurations, WPS Office provides a streamlined, lightweight, and powerful alternative for your team's daily document needs. It offers a familiar interface and avoids the overhead of complex tenant management.
- 1. Visit the official website: Go to the official WPS Office website to find the free download link.
- 2. Download the installer: Click the 'Free Download' button to get the lightweight installation package.
- 3. Install and launch: Run the installer and open WPS Office to immediately start creating and editing your documents without complex server configurations.
Frequently Asked Questions
Why does my custom Outlook add-in deployment fail in a hybrid Exchange setup?
In hybrid environments, centralized deployment requires strict synchronization between your on-premises Exchange and Azure AD. If OAuth authentication is misconfigured or directory sync has underlying errors, the final deployment step will automatically fail.
How can I check if my add-in XML manifest is valid before uploading?
You can use the 'office-addin-manifest' command-line validator tool provided by Microsoft, or manually check the XML file against the official Office Add-ins XML schema documentation to ensure no required properties are missing.
Can I publish custom apps in Microsoft 365 without Global Admin rights?
No. To deploy custom applications organization-wide or via centralized deployment in the Microsoft 365 admin center, you must be assigned the Global Administrator or Exchange Administrator role.
