Add your organization's brand to your encrypted messages

As an Exchange Online or Exchange Online Protection administrator, you can apply your company branding to customize the look of your organization's Office 365 Message Encryption email messages and the contents of the encryption portal. Using the Get-OMEConfiguration and Set-OMEConfiguration Windows PowerShell cmdlets, you can customize the following aspects of the viewing experience for recipients of encrypted email messages:

  • Introductory text of the email that contains the encrypted message

  • Disclaimer text of the email that contains the encrypted message

  • Text that appears in the OME portal

  • Logo that appears in the email message and OME portal

  • Background color in the email message and OME portal

You can also revert back to the default look and feel at any time.

This article is part of a larger series of articles about Office 365 Message Encryption. This article is intended for administrators and ITPros. If you're just looking for information on sending or receiving an encrypted message, see the list of articles in Office 365 Message Encryption (OME) and locate the article that best fits your needs.

To customize the look of the OME portal and email messages encrypted by OME with your organization's brand

  1. Connect to Exchange Online using Remote PowerShell, as described in Connect to Exchange Online Using Remote PowerShell.

  2. Use the Set-OMEConfiguration cmdlet as described in Set-OMEConfiguration or use the following table for guidance.

Encryption customization options

To customize this feature of the encryption experience Use these commands
Default text that accompanies encrypted email messages. The default text appears above the instructions for viewing encrypted messages
Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -EmailText "<String up to 1024 characters>"
Example:
Set-OMEConfiguration -Identity "OME Configuration" -EmailText "Encrypted message from ContosoPharma secure messaging system."
Disclaimer statement in the email that contains the encrypted message
Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -DisclaimerText "<Disclaimer statement. String of up to 1024 characters.>"
Example:
Set-OMEConfiguration -Identity "OME Configuration" -DisclaimerText "This message is confidential for the use of the addressee only."
Text that appears at the top of the encrypted mail viewing portal
Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -PortalText "<Text for your portal. String of up to 128 characters.>"
Example:
Set-OMEConfiguration -Identity "OME Configuration" -PortalText "ContosoPharma secure email portal."
Logo
Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -Image <Byte[]>
Example:
Set-OMEConfiguration -Identity "OME configuration" -Image (Get-Content "C:\Temp\contosologo.png" -Encoding byte)
Supported file formats: .png, .jpg, .bmp, or .tiff
Optimal size of logo file: less than 40 KB
Optimal size of logo image: 170x70 pixels
Background color
Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -BackgroundColor "<Hexadecimal color code>"
Example:
Set-OMEConfiguration -Identity "OME Configuration" -BackgroundColor "#ffffff"

To remove brand customizations from the OME portal and email messages encrypted by OME

  1. Connect to Exchange Online using Remote PowerShell, as described in Connect to Exchange Online Using Remote PowerShell.

  2. Use the Set-OMEConfiguration cmdlet as described in Set-OMEConfiguration. To remove your organization's branded customizations from the DisclaimerText, EmailText, and PortalText values, set the value to an empty string, "". For all image values, such as Logo, set the value to "$null".

Encryption customization options

Use these commands
Default text that accompanies encrypted email messages
The default text appears above the instructions for viewing encrypted messages
Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -EmailText "<empty string>"
Example:
Set-OMEConfiguration -Identity "OME Configuration" -EmailText ""
Disclaimer statement in the email that contains the encrypted message
Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> DisclaimerText "<empty string>"
Example:
Set-OMEConfiguration -Identity "OME Configuration" -DisclaimerText ""
Text that appears at the top of the encrypted mail viewing portal
Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -PortalText "<empty string>"
Example reverting back to default:
Set-OMEConfiguration -Identity "OME Configuration" -PortalText ""
Logo
Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -Image <"$null">
Example reverting back to default:
Set-OMEConfiguration -Identity "OME configuration" -Image $null
Background color
Set-OMEConfiguration -Identity <OMEConfigurationIdParameter> -BackgroundColor <"$null">
Example reverting back to default:
Set-OMEConfiguration -Identity "OME configuration" -BackgroundColor $null