The LibraCyber report button only needs to be installed once, either for everyone or for specific groups, by your email platform administrator: the Outlook add-in for Microsoft 365, or the Gmail add-on for Google Workspace. The console provides a step-by-step guide.
- A · LibraCyber Outlook Add-in (Microsoft 365)
- What to do
- Expected result
- How long to wait
- Verify it works
- Revoke or undo
- Limit the scope
- What does the add-in require?
- How do I update the add-in, for example to the LibraCyber name?
- Can we have the add-in with our own branding?
- B · LibraCyber Gmail Add-on (Google Workspace)
- What to do
- Expected result
- How long to wait
- Verify it works
- Revoke or undo
- Limit the scope
- What does the Gmail add-on require?
A · LibraCyber Outlook Add-in (Microsoft 365)
The add-in adds a Report phishing to LibraCyber button to Outlook. A Global Administrator deploys it once, for everyone or for specific groups, from the Microsoft 365 admin center. The console provides a step-by-step guide.
What to do
- Optional, if your role includes the Setup permission for Phishing Simulation: in the LibraCyber console, open Phishing Simulation › Setup, go to the Setup Checklist tab, find the Report Button Deployment step, and select Go to installation guide. The guide shows the steps below with images.
Phishing Simulation › Setup › Setup Checklist, step Report Button Deployment. ① Go to installation guide ② I confirm I have completed the guide.
- In the Microsoft 365 admin center, open Settings › Org settings, go to the Services tab, then Modern authentication, and make sure modern authentication is enabled. Outlook for Windows requires this, and tenants created before August 2017 may have it turned off.
- Open Settings › Integrated apps, select Add-ins, then Deploy Add-In, and select Next.
- Select Upload custom apps, choose I have a URL for the manifest file, and enter
https://office.mantra.ms/manifest.xmlin full, includinghttps://. Select Upload.Microsoft 365 admin center › Integrated apps › Add-ins, Deploy a new add-in: manifest link entered. ① I have a URL for the manifest file ② Upload
- In Assign Users, choose Everyone, Specific users / groups, or Just me. Leave Deployment Method set to Fixed (Default) so users can't remove the button, and select Next.
- Review the permissions requested by the add-in, select Save, then Close.
- If you opened the guide in step 1, check I confirm I have completed the guide. in the Report Button Deployment step.
Expected result
Integrated apps will list the Report Phishing add-in. Users will see Report phishing to LibraCyber on received emails. In Outlook for Windows and Mac, it's in the Report Phishing ribbon group. In the new Outlook and Outlook on the web, look for it under Apps or …. On mobile, open the email's … menu.
How long to wait
It can take up to 72 hours for the button to appear in users' Outlook; often it shows up in Outlook on the web within a few minutes. Users may need to restart Outlook.
Verify it works
In Integrated apps, the add-in will show the users or groups you selected. In Outlook, open a received email: the button should be there. Then report a test email (Step 7: Verify it works): the panel will show Thank you for reporting this email.
Revoke or undo
In Integrated apps, select the add-in and remove it. It will disappear from Outlook after the same delay as deployment.
Limit the scope
Assign it to specific users or groups in step 5; you can change the assignment later in Integrated apps.
Details: Report a suspicious email › How do I report with the LibraCyber add-in?
What does the add-in require?
Read access to the reported email and the user's access to Microsoft 365. The add-in only reads the email the user reports, when they select the button; it doesn't read other emails and doesn't move or delete anything. The access (name and email address) tells LibraCyber who is reporting, so only registered users can report. These are the permissions you accept in step 6.
How do I update the add-in, for example to the LibraCyber name?
Update it in Integrated apps using the same link. The add-in's content updates automatically, but its name, button label, and icon in Outlook depend on what you deployed: a tenant that deployed it before May 2026 may still show the old name.
- In Integrated apps, open the add-in you've already deployed.
- Choose to update it, using the link
https://office.mantra.ms/manifest.xml.
Don't upload it again as a new app: Microsoft will reject it because it's already deployed. The update will reach users with the same delay as a deployment.
Can we have the add-in with our own branding?
No. Every company uses the standard LibraCyber add-in: the name, button label, icon, and colors can't be changed at this time.
B · LibraCyber Gmail Add-on (Google Workspace)
The add-on adds a LibraCyber report button to Gmail. A Google Workspace administrator installs it once, for everyone or for specific groups, from the Google Workspace Marketplace. The console provides a step-by-step guide.
What to do
- Optional, if your role includes the Setup permission for Phishing Simulation: in the LibraCyber console, open Phishing Simulation › Setup, go to the Setup Checklist tab, find the Report Button Deployment step, and select Go to installation guide. For a company on Google Workspace, the guide shows the steps below.
- Open the add-on page in the Google Workspace Marketplace, LibraCyber Phishing Report Button for Gmail, using your company's admin account, not a personal one.
- Select Admin install, then Continue.
- Choose who gets it: your entire organization, or specific groups or organizational units. Accept the Terms of Service, then select Finish and Done.
- If you opened the guide in step 1, check I confirm I have completed the guide. in the Report Button Deployment step.
Expected result
Users will see the LibraCyber button when they open a received email in Gmail.
How long to wait
It can take up to 24 hours for the add-on to reach all users.
Verify it works
In the Google Admin console, Apps › Google Workspace Marketplace apps › Apps list will show the add-on. In Gmail, open a received email: the LibraCyber button should be there. Then report a test email (Step 7: Verify it works).
Revoke or undo
In the Google Admin console, Apps › Google Workspace Marketplace apps › Apps list, select the add-on and uninstall it.
Limit the scope
Install it for specific groups or organizational units in step 4; you can change this later in the Google Admin console.
Details: Report a suspicious email › How do I report with the LibraCyber Gmail add-on?
What does the Gmail add-on require?
Access to the reported email and the user's access to Google. The add-on reads the email the user reports, when they select the button. The access (email address) tells LibraCyber who is reporting, so only registered users can report. These are the permissions shown on the Marketplace page and accepted during installation.