Customizing › Custom Branding › Themes › How to Create Custom Themes

How to Create Custom Themes

You create a custom theme by copying and modifying an existing theme. You can copy and modify either a predefined CA Service Catalog theme or another existing theme that you created earlier. Using a custom theme for a business unit helps support branding or other messaging for the business unit and, optionally, its child business units.

Important! As a best practice, do not modify a predefined CA Service Catalog theme directly. Instead, copy and modify it, so that you can efficiently return to the original version, if necessary. Always back up CSS files before editing them.

To customize a theme, follow this process:

1. Verify that you meet the prerequisites for editing themes.
2. Access the computer on which the filestore resides.
3. Find and expand the %USM_HOME% folders. Expand the \filestore\themes folder. Review the organization of the predefined and custom themes in that folder.

   Note: The name of each top-level folder is the name of an option that you can select when you select a theme for a business unit.

4. Copy the top-level folder of existing theme that you want to use as a starting point for your new theme.
5. Wait for the copy operation to finish and rename the new theme.

   For example, suppose the existing theme was named Rome_Super_Tenant_A. If the new theme is for a second super tenant, you can name it Rome_Super_Tenant_B. Conversely, if the new theme is for a new child business unit of the parent super tenant, you can name it Rome_Super_Tenant_A--Child-1.

6. Add or edit the business unit for which you want to use this theme. In the Available Branding field, select the new theme that you created.

   For example:

   • To apply the theme to all business units that do not have their own theme, edit the root business unit and apply this theme.
   • To apply the theme to a specific business unit, add or edit the business unit and apply the theme.

     The theme also applies to all child business units that do not have their own theme.

7. Customize the new theme by editing its main.css file.

You have created the new theme and are now ready to begin customizing it.