Modifying and uploading your own theme

You can modify the default theme by adding your own customizations and then saving it as a different theme. You can then upload it to IBM® Cognos® Analytics for later use.

1. Download the default theme.
   1. Click the Open menu icon , and then click Manage > Customization.
   2. Click the Themes tab, if it's not already selected.
      Tip: By default, IBM Carbon X is selected.
   3. Click the Menu icon for IBM Carbon X and then select Download.
      

      The file IBM_Modern.zip is downloaded to your computer.

   4. Extract IBM_Modern.zip.
   5. Open the extracted file spec.json in a text editor.

      The content appears as follows

      {
          "brandTextSmall": "IBM Cognos Analytics",
          "images": {
              "altText": "CA Logo",
              "favicon": "images/favicon.ico",
              "brandIcon": "common-CA_Avatar_Colour_64",
              "brandIconSmall": "common-CA_Avatar_Black_24"
          },
          "schemaVersion": "3.0",
          "uiShellTheme": "dark",
          "paletteId": "IBM_Modern",
          "brandText": "IBM Cognos Analytics",
          "name": "IBM Carbon X",
          "colors": {
              "appbarForeground": "#fff",
              "appbarBackground": "#161616",
              "navbarForeground": "#161616",
              "toolbarForeground": "inherit",
              "toolbarBackground": "inherit",
              "appbarPushButtonBackground": "#393939",
              "navbarSelectLine": "#0f62fe",
              "navbarPushButtonBackground": "#e0e0e0",
              "appbarSelectLine": "#fff",
              "navbarBackground": "#fff",
              "personalMenuBackground": "inherit",
              "toolbarPushButtonBackground": "inherit",
              "toolbarSelectLine": "inherit"
          }
      }

2. Modify parameters of the spec.json to suit your needs.
   Tip: To see examples of different parameter values and their effect on the Cognos Analytics user interface, see View images that show how each parameter in the IBM_Blue_Green theme is applied
3. Save the spec.json file.
4. Compress your modified spec.json file and give it a unique name, for example,yourname.zip.
5. Upload yourname.zip
   1. Click the Open menu icon , and then click Manage > Customization.
   2. On the Themes tab, click Upload theme () and browse to the theme you created, for example, yourname.zip.
   3. Click Open.
      Your theme is uploaded and validated. If the theme is invalid, an error message is displayed. Otherwise, the theme is added to the list of available themes. To see the theme you added, refresh your browser.
   Tip: You can click the Menu icon next to a theme to update, delete, or download the theme.