Forum Discussion
A custom mobile Outlook add-in is not loading, which is working well in the Outlook Web
We have created a manifest file by following the link as mentioned in the Microsoft Documentation
https://learn.microsoft.com/en-us/office/dev/add-ins/outlook/mobile-event-based?tabs=jsonmanifest
and uploaded to O365 admin for using it in Web application and mobile application, but Add-in is not showing in the Mobile application Add-in list.
I have tried clearing cache in the mobile app and also tried PowerShell Command
Set-OrganizationConfig -OutlookMobileGCCRestrictionsEnabled $false
but it is not working.
My questions are:
- Have we missed anything after deployment or in the Manifest file?
- Do we need to run any other PowerShell commands to display the application in the Mobile Outlook Add-in list?
- In some forums it was mentioned that the Add-in needs to be Whitelisted, is there any such thing. If so, how to do that?
Please suggest us on how to proceed and help us with this manifest file (Add-in) to be working in the Outlook mobile application.
1 Reply
1. Basic troubleshooting steps
Validate the plugin manifest
xml
<! -- Check for MobileFormFactor support in manifest -->
<Requirements>
<Sets>
<Set Name=“Mailbox” MinVersion=“1.1”/>
</Sets>
</Sets> </Requirements>
<MobileFormFactor
<ExtensionPoint xsi:type=“MobileMessageReadCommandSurface”>
<! -- Must contain mobile configuration -->
</ExtensionPoint>
</MobileFormFactor>
Running HTML
2. Clear client-side cache
Android:
bash
adb shell pm clear com.microsoft.office.outlook
iOS:
Uninstall and reinstall Outlook
Disable “Battery Optimization” on first boot
3. Permission and Deployment Check
Verify API permissions
Verify the API permissions.
# Check Azure AD application registration permissions
Get-AzureADServicePrincipal -Filter “AppId eq ‘YOUR_APP_ID’” |
Select -ExpandProperty Oauth2Permissions
Required permissions: Mail.ReadWrite, MailboxSettings.Read
4. Redeploy the plugin
powershell
# Manage via Exchange Online
Publish-OutlookAddIn -ManifestFile “manifest.xml” -OrganizationAddIn
5. mobile-specific fixes
Force HTTPS loading
Ensure all resource URLs use https://
Disable mixed content:
html
<meta http-equiv=“Content-Security-Policy” content=“upgrade-insecure-requests”>
Run HTML
6. Network Policy Adjustment
powershell
# Enterprise environments need to allow plugin domains
New-MobileDeviceMailboxPolicy -Name “AllowAddInDomains” -AllowedInboundUrlPatterns @(“*.yourdomain.com”, “*.azurewebsites.net”)
7. Debugging and log collection
Android debugging
bash
# View Outlook mobile logs
adb logcat -s Outlook | grep “AddInLoader”
iOS Diagnostics
8. Search through the Xcode device console:
[OutlookAddIn] Error Domain
9. Simulator test
bash
# Test in Android emulator
emulator -avd Pixel_API_30 -http-proxy http://localhost:8080
10. Proxy Capture
Configure Charles Proxy
Capturing outlookmobile://addin protocol requests
