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

    To revert this feature of the encryption experience back to the default text and image

    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

Expand your skills
Explore training
Get new features first
Join Office Insiders

Was this information helpful?

Thank you for your feedback!

Thank you for your feedback! It sounds like it might be helpful to connect you to one of our Office support agents.

×