How Do I Change the Phish Alert Text for Microsoft 365 and Hybrid Phish Alert Buttons?

If you're using the Hybrid version of the Phish Alert Button (PAB) in Outlook 2016 and you would like to add text to the PAB, you are able to.

How Do I Change the Text?

Prior to installing the PAB on your mail server, download the O365Manifest.xml, or PhishAlertManifest.xml, file from your KnowBe4 Account Settings.

If you would like to change the PAB text for OWA, open this file in a text editor and edit the following line of text:

If you would like to change the PAB text for Outlook, open the O365Manifest.xml, or PhishAlertManifest.xml, file from your KnowBe4 Account Settings.

The PhishAlertManifest.xml will have two <bt:ShortStrings> sections that will need to be changed for the PAB text to be applied. The first set of strings are used when your Outlook PAB is in Exchange mode. The second set of strings are used when you are using Microsoft 365. Any override values will be used for specific locales and the default values will be used for unsupported locales.

Add your customized PAB text to the DefaultValue text for both the groupLabel and paneReadButtonLabel. Then, save the file and install the PAB as you normally would.

If you've already installed the PAB on your server, you can follow the same steps as above to edit your PAB text. Once your edits are complete, you will need to:

1. First, remove your existing PAB add-in from Microsoft 365.
2. Then, add the new .xml file you've edited as an add-in.

Your users will then see the PAB with the custom text you created, as shown in the example below:

If you would like to localize the text of PAB, you can replace the language codes in the DisplayName Override values as shown below. All of the Override Locale sections need to be modified in order for your changes to display. You can find a list of official language identifiers in Microsoft's Language identifiers and OptionState Id values article and a list of ISO codes in the List of ISO 639-1 codes found on Wikipedia.

Please note that the lines of text shown in the above images may vary depending on the number of languages that were added to your PAB instances through our Language Aware feature. To learn more about the language-aware feature for Microsoft 365, please visit our Adding Languages to the Phish Alert Button article.

How Do I Change the Hover Over Text?

To change the Hover Over Text, use the same O365Manifest.xml, or PhishAlertManifest.xml, file from your KnowBe4 Account Settings, open the file in a text editor and edit the following lines of text:

If you using the PhishAlertManifest.xml file, there are two paneReadSuperTitle strings that need to be updated. The updated override values shown in the image below will apply to supported locales and the default values will apply to the unsupported locales.

Follow the instructions listed in the How Do I Change the Text section of this article, to enter the replacement text in the DefaultValue for the labels that say "Phish Alert".