This documentation supports the 19.05 version of BMC Digital Workplace Advanced.

To view an earlier version, select the version from the Product Version menu.

Rebranding BMC Digital Workplace

As a BMC Digital Workplace administrator, you can rebrand BMC Digital Workplace for your end users. To suit your company's branding, you can change the default logo, background color, and colors for the primary, secondary, and active elements. 

The rebranding tool, available from the BMC Digital Workplace Admin console, is intuitive and easy to use.

If you are upgrading from a previous version

Since version 19.02, rebranding is performed using the Admin console, and eliminates the need for manually writing the CSS code. All rebranding changes you made in version 19.02 will be migrated to the current version.

However, if you upgrade from a version prior to 19.02, you will have to perform the steps described in this topic, since your existing settings will not be migrated.

Related topic

Before you begin

If you have a multitenant environment and are using the BMC Digital Workplace login, configure multitenancy.

If you are using an alternative sign-on process (such as Remedy Single Sign-On), do not rebrand the BMC Digital Workplace login page.

To create image files for rebranding

  • Background image for login page
  • Main page header logo
  • Mobile logo

The following table provides guidelines for creating the required images. Create and save the files to a location that you can access from the server.

Background image for the login page

You can upload only one login page image. For faster loading, use lower resolution images.

Example of the background image for the login page image with white background:

Product logo

The logo file that you will upload must meet the following requirements:

  • Supported file formats: JPG, JPEG, PNG, and GIF.
  • The maximum file size is 200 KB
  • The width-to-height ratio should be 1:1 or wider. You can also set a custom width-to-height ratio for the product logo.

Recommendation: Transparent PNG, 48H x 80W

Mobile logo

The logo file that you will upload must meet the following requirements:

  • Supported file formats: JPG, JPEG, PNG, and GIF.
  • The maximum file size is 1024 KB.

Recommendation: Transparent PNG, 512H x 512W

To rebrand BMC Digital Workplace

You can upload the logo and background images, and choose colors for various elements in the user interface. According to your selections, the BMC Digital Workplace rebranding automatically applies changes to the user interface.

In addition to the steps below, the following video (6:43) describes how to rebrand BMC Digital Workplace:

  1. Log in to the BMC Digital Workplace Admin console, and select  Configuration > Branding.  
  2. Rebrand the required elements as described in the table following the preview image below.


    To view your changes as they are updated dynamically, use the UI Preview, available on the right.

    If you are using a login mechanism (for example, Remedy Single Sign-on) that bypasses the BMC Digital Workplace login page, do not customize the login page settings.

    Rebranding areaAction
    Global NavigationTo change from the default dark global navigation style, select Dark, Light, or Gray.

    To update the product name, type your product name in the Product name field.

    Tip: If required, you can leave this field blank.

    To update the Product logo, click Add logo, or drag and drop the image file. Important: A branded product logo cannot be displayed in Safari browser on iOS mobile devices. The BMC default icon is displayed instead.

    To update the Favicon for mobile devices, click Attach File, or drag and drop the image file.

    This image will be used for the icon when users add BMC Digital Workplace to the home screen of their mobile devices.


    The Favicon will not be available on Microsoft Edge.

    To update the Home screen icon for Android device, click Attach file, or drag and drop the image file.

    To update the Primary state color, use the color picker tool, enter a hexadecimal code, or enter the RGB values. Select or clear the Use light text check box for defining the text color.

    To update the Secondary state color, use the color picker tool, enter a hexadecimal code, or enter the RGB values. Select or clear the Use light text check box for defining the text color.
    To update the Active state color, use the color picker tool, enter a hexadecimal code, or enter the RGB values.

    Login page

    Use Background color to specify the background color for the login page.

    The gradients (if selected) will be applied to this color.

    Note: You cannot delete or modify the Powered by BMC inscription at the bottom of the login page.

    (Optional) Use Background: image to select a background image for the login page. Provide the image URL to be used in the background, and select the options to customize the look and feel.

    (Optional) Use Background: linear gradient to configure the linear gradient by specifying one or more of the available settings.

    (Optional) Use Background: radial gradient to configure the radial gradient by specifying one or more of the available settings.

  3. To save your changes, click Apply changes.
  4. (Optional) If you are using the BMC Digital Workplace login, download the adapt-css-bs4min.css and adapt-css-mobile.min.css files.

To apply customization to the BMC Digital Workplace login

If you use the BMC Digital Workplace login, follow this procedure to apply the customization to the login screen. This procedure uses the CSS files that you generated in To rebrand BMC Digital Workplace. This procedure does not apply if you use an alternative sign-on process, such as Remedy Single Sign-On.

  1. On the BMC Digital Workplace server, run the following command:

    (Windows) list_tenants.bat 

    The ID for the default tenant is 000000000000001, and the other ID values correspond to the other company tenants.

  2. If %TOMCAT_HOME%/webapps/tenant-custom-res/ does not exist on your BMC Digital Workplace server, create the tenant-custom-res directory.
  3. Copy the CSS files to the tenant-custom-res directory.
  4. Clear the Apache Tomcat cache by deleting the Catalina directory located at C:\Program Files\Apache Software Foundation\Tomcat8.0\work.
  5. Restart the Apache Tomcat server.

To verify rebranding

Open  http://localhost:9000/dwp/app in a browser.


In multitenant environments, the login screen is the same for all tenants. To check the rebranding for a specific tenant, log in as a user who belongs to that tenant company.

To hide features from end users

Log in to the BMC Digital Workplace Admin console, and select  Configuration > Application Features to enable or disable the following features. For more information, see Enabling end user features.

Where to go from here

Customizing BMC Digital Workplace

Was this page helpful? Yes No Submitting... Thank you


  1. Kevin Candelaria

    Is it possible to have custom branding on Digital Workplace 19.02 like the previous versions where you modified tenant-custom-res\000000000000001\style-myit.css ?

    Mar 22, 2019 11:09
    1. Ravee Panjwani

      Thanks for your comment, Kevin.

      With the 19.02 release, we are provided the new branding configuration mentioned above, along with the capability to enable/disable several features via the user interface. This procedure replaces the need to modify the css.


      Mar 22, 2019 12:16
      1. Jani Myllymãƒâ¤ki

        No this does not replace the need to do modifications to .css file. The tool doesn't allow big enough logo for the portal, the tool don't allow to change any other elements defined, the tool doesn't allow to add logo on right side of the portal

        AND most important the tool doesn't allow to do .css styling for different tenants or atleast I have not found any instructions to do styling for different tenants

        Apr 30, 2019 04:48
        1. Ting He


          Thanks for giving your feedback. DWP new UI rebranding and configuration are designed to be completely self-service: a customer can make those changes without being an expert in SCSS, without needing to change files on server file system, without the risk breaking accessibility and displaying on multiple form factors. It is also designed to be upgrade transparent, any changes a customer made will be kept after upgrade without manual intervention. Together these design objectives benefit all customers, and are necessary for Helix customers. Therefore we need to move away from manual CSS change. Please submit ideas for UI changes you need and they will be evaluated for product enhancement.

          Rebranding, like all features in DWP Admin console, is tenant aware. If you have two tenants, login to DWP admin console as respective admin for each tenant, make respective rebranding changes for each. When users from different tenants login to DWP, they will see respective rebranding changes.



          May 01, 2019 04:37
  2. Maria Blajevitch

    The Brandning tool is very nice and probably help starters. Unfortunately it does not allow much to the Professional Services. Please provide the explanation how can we perform more changes to the fonts, more colors and other UX parameters. Maria

    Apr 14, 2019 01:55
    1. Ting He

      Hi Maria, the new UI in 1902 uses dynamic CSS to ensure accessibility and responsive design, it no longer supports manual change. UI customizations that were done via CSS manual changes are being converted to UI configuration features, which is necessary for Helix deployment. If you see UI customization need not supported by configuration, please submit ideas for them.



      Apr 26, 2019 03:24
      1. Jani Myllymãƒâ¤ki

        Yes, but how to do different views for different tenants! Beside this kind of downgrading your portal capabilities have nothing to do with "accessibility and responsive design"

        Apr 30, 2019 04:50
  3. Stuart Olliver

    We've had a big push over the past 12 months on promoting new use of "My IT", so with it being rebranded "Digital Workplace" we will have to make use of the rebranding options described above to avoid confusing our users. There is one place we would like to change "Digital Workplace" to "My IT" that can't be done using the config screens, and that is the main login page.

    How do we change the words "Digital Workplace" on the login page please?

    May 08, 2019 03:13
    1. Ravee Panjwani

      Thanks for your comment, Stuart. Can you please confirm if you are using BMC Digital Workplace with or without BMC Remedy Single Sign-On?

      The settings provided here for the login page will work only if you are not using BMC Remedy Single Sign-On or another SSO within your organization.

      May 08, 2019 12:35