Customize the Outlook on the web sign-in, language selection, and error pages in Exchange Server

The Outlook on the web (formerly known as Outlook Web App) sign-in, language selection, and error pages are based on image and content style sheet (CSS) files in the themes resources folder in the Client Access (front end) services on an Exchange Server 2016 or Exchange 2019 server. Outlook on the web uses only one set of sign-in, language selection, and error pages for all themes. Any modifications to those pages will be seen by all users who connect to the Exchange server for Outlook on the web.

Notes:

  • Backup the default Outlook on the web files before you make any changes.

  • Create a back-up copy of your customized files so you can reapply them after a reinstallation or upgrade of the Exchange server.

  • If you use multiple Exchange servers for Outlook on the web connections, you need to copy the modified files to each server.

For more information about Outlook on the web, see Outlook on the web in Exchange Server. For information about creating a custom theme, see Create a theme for Outlook on the web in Exchange Server.

What do you need to know before you begin?

  • Estimated time to complete this task: 30 minutes.

  • You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Graphics editor" entry under "Outlook on the web Permissions" in the Clients and mobile devices permissions topic.

  • To replace the existing color with a new color, you need the HTML RGB value of the new color. You can find HTML RGB values in the topic Color Table. If you can't find the color there, you can use an image editing tool to sample a color and determine its HTML RGB value.

  • For information about keyboard shortcuts that may apply to the procedures in this topic, see Keyboard shortcuts in the Exchange admin center.

Tip

Having problems? Ask for help in the Exchange forums. Visit the forums at: Exchange Server, Exchange Online, or Exchange Online Protection.

Customize the color of the Outlook on the web sign-in page

  1. Use Notepad to open the file %ExchangeInstallPath%FrontEnd\HttpProxy\owa\auth\<ExchangeVersion>\themes\resources\logon.css.

    Note: The <ExchangeVersion> subfolder uses the syntax 15.1. nnn. nn, and changes every time you install an Exchange Cumulative Update (CU).

  2. In the logon.css file, replace the default blue color value #0072c6 with the HTML RGB value that you want to use.

  3. When you're finished, save and close the file.

    Outlook on the Web sign-in page with element call-outs.

Customize the color of the Outlook on the web error page

  1. Use Notepad to open the file %ExchangeInstallPath%FrontEnd\HttpProxy\owa\auth\<ExchangeVersion>\themes\resources\errorFE.css.

  2. In the errorFE.css file, replace the default blue color value #0072c6 with the HTML RGB value that you want to use.

  3. When you're finished, save and close the file.

    Outlook on the web error page with element call-outs.

Customize the color of the Outlook on the web language selection page

  1. Use Notepad to open the file %ExchangeInstallPath%ClientAccess\Owa\prem\<ExchangeVersion>\resources\styles\languageselection.css.

  2. In the languageselection.css file, replace the default blue color value #0072c6 with the HTML RGB value that you want to use.

  3. When you're finished, save and close the file.

    Outlook on the web language selection page with element call-outs.

Customize the images on the Outlook on the web sign-in, language selection, and error pages

You can edit the existing image files, or replace the files with new files that have the same names and dimensions. The images are described in the following table:

Image File name Location Dimensions (width x height in pixels) Bit depth
1 favicon.ico %ExchangeInstallPath%FrontEnd\HttpProxy\owa\auth\<ExchangeVersion>\themes\resources 16 x 16 32
2 olk_logo_white.png %ExchangeInstallPath%ClientAccess\Owa\prem\<ExchangeVersion>\resources\images\0 128 x 108 32
3 owa_text_blue.png %ExchangeInstallPath%ClientAccess\Owa\prem\<ExchangeVersion>\resources\images\0 300 x 76 32
4 Sign_in_arrow.png (for left-to-right languages)

Sign_in_arrow_rtl.png (for right-to-left languages)

%ExchangeInstallPath%FrontEnd\HttpProxy\owa\auth\<ExchangeVersion>\themes\resources 22 x 22 32
5 olk_logo_white_cropped.png %ExchangeInstallPath%FrontEnd\HttpProxy\owa\auth\<ExchangeVersion>\themes\resources 265 x 310 32
6 office_logo_white_small.png %ExchangeInstallPath%ClientAccess\Owa\prem\<ExchangeVersion>\resources\images\0 (for left-to-right languages)

%ExchangeInstallPath%ClientAccess\Owa\prem\<ExchangeVersion>\resources\images\rtl(for right-to-left languages)

81 x 26 8

How do you know this worked?

To verify that you've successfully customized the Outlook on the web sign-in, language selection, and error pages, perform the following steps:

  1. Open the Outlook on the web sign-in page in a web browser. On the Exchange server that hosts the Outlook on the web virtual directory, you can test your changes by opening the URL https://localhost/owa or https://127.0.0.1/owa.

  2. If you don't see your changes, clear your browsing history (delete temporary Internet files), and refresh the browser window.

    Note: To see the effects of your changes, you can keep the .css file open and refresh the browser window after you save each change.