How to Deploy the Microsoft Ribbon Reporter Add-In
How to Install the Microsoft Ribbon Phishing Reporter
Customize Phishing Reporter for your organization's needs
Go to Phishing Reporter > Manage and Download section and click “Connect Account”

Log in to your Microsoft 365 account using your admin credentials.
Once you log in, the Permissions requested pop-up window will display. Read the permissions, then click Accept.

Once you accept the permissions, the GRAPH Authorization Successful window will display.

Click the Download icon below the Microsoft Ribbon Phishing Reporter option to download the PhishingReporterRibbon.xml file.
In a new tab of your browser, log in to your Microsoft 365 admin center.

From the menu on the left side of the page, click Settings.
From the Settings drop-down menu, select Integrated apps.

Click Add-ins at the top-right corner of the page. The Add-ins page will open

On the Add-ins page, click Deploy Add-In. The Deploy a new add-in pop-up window will open.

In the pop-up window, click Next.

Click Upload custom apps.

Select the I have the manifest file (.xml) on this device option. Then, click Choose File and select the PhishingReporterRibbon.xml file that you downloaded in step 6.

Click Upload to install the Phishing Reporter. The Configure add-in pop-up window will open.

From the pop-up window, select which users will have access to the Phishing Reporter and which method you would like to use to deploy the Phishing Reporter.

Click Next, and additional app permissions will display.
Once you have read the permissions, click Save. The Deploy Phishing Reporter pop-up window will open.

The expected timeframe for the Phishing Reporter to deploy is 24 hours, but timeframes can vary. For more information about deploying add-ins, see Microsoft's Deploy add-ins in the Microsoft 365 admin center article.
Once the pop-up window displays a confirmation that the add-in successfully deployed, click Next. The Announce add-in pop-up window will open and display a message about announcement recommendations from Microsoft.

Click Close to close the pop-up window.
Troubleshooting Microsoft Ribbon Phishing Reporter
We were unable to process this item. Please try again later.
"We were unable to process this item. Please try again later." message in the Ribbon Phishing Reporter in Outlook.


The suggested solution is to "Toggling on New Outlook"

Tutorial Video
This video tutorial shows the documentation steps for deploying Microsoft Ribbon Phishing Reporter add-in on M365.
Last updated
Was this helpful?