> ## Documentation Index
> Fetch the complete documentation index at: https://docs.domino.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Customize the Domino UI

If you are using an on-premises deployment of Domino, you can use white labeling to customize the Domino interface with your organization’s brand, external resource links, banner, footer, and more. You can also remove specific UI elements to hide functionality according to your organization’s needs.

White labeling is controlled by certain Configuration keys. See [Configuration records](/6.3/admin/configuration/central-configuration#white-labeling) for definitions of these keys.

## Customize the banner

Create a custom HTML banner for every page on Domino to notify users of important announcements and information.

1. In the admin portal, go to **Platform settings > Configuration records**.

2. Set `com.cerebro.domino.frontend.globalBanner.content` to the HTML that you want shown in the banner.

   1. Example: `<div style="background-color: blue; font-size: 50px;">Global Banner</div>`

3. Set `com.cerebro.domino.frontend.globalBanner.isClosable` to let users close the banner.

4. Set `com.cerebro.domino.frontend.globalBanner.reappearTimeAfterCloseInSec` to specify how many seconds pass before the banner reappears. If the key is not specified, the banner will stay closed.

## Customize the footer

1. In the admin portal, go to **Platform settings > Configuration records**.

2. Set `com.cerebro.domino.frontend.footerCustomization.customFooterHtml` to the custom HTML that you want shown just above the page footer.

## Customize the footer image

1. In the admin portal, go to **Platform settings > Configuration records**.

2. Set `com.cerebro.domino.frontend.footerCustomization.customFooterImageUrl` to a URL for the image that you want shown in the footer. The image displays on the same line as the Domino logo. If `customFooterHTML` is set, this displays below the custom HTML, inside the footer.

## Customize the Contact Us link

1. In the admin portal, go to **Platform settings > Configuration records**.

2. Set `com.cerebro.domino.frontend.footerCustomization.customContactUsHref` to a URL that directs your users to a web-based form or email address (`mailto:support@domain.com`).

## Advanced customization

The `com.cerebro.domino.whitelabel.jsonConfig` configuration key supports additional white labeling parameters in JSON format:

<table>
  <thead>
    <tr>
      <th>Key</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td colSpan="2"><p><em>Design elements</em></p></td>
    </tr>

    <tr>
      <td><p><code>appLogo</code></p></td>
      <td><p><strong>Optional</strong>: The absolute URL of the logo image, or <code>none</code> to display the Domino logo.</p></td>
    </tr>

    <tr>
      <td><p><code>appLogoBgColor</code></p></td>
      <td><p><strong>Optional</strong>: The background color of the logo; the default is "transparent". Any CSS color value is valid.</p></td>
    </tr>

    <tr>
      <td><p><code>appURL</code></p></td>
      <td><p><strong>Optional</strong>: The application URL; the default is "[https://domino.ai/](https://domino.ai/)".</p></td>
    </tr>

    <tr>
      <td><p><code>appName</code></p></td>
      <td><p>The application name (such as Domino).</p></td>
    </tr>

    <tr>
      <td><p><code>defaultProjectName</code></p></td>
      <td><p>The default project name.</p></td>
    </tr>

    <tr>
      <td><p><code>favicon</code></p></td>
      <td><p>The absolute URL of the favicon image.</p></td>
    </tr>

    <tr>
      <td><p><code>gitCredentialsDescription</code></p></td>
      <td><p>A description to show in the Git credentials configuration window.</p></td>
    </tr>

    <tr>
      <td><p><code>govern.bundle</code></p></td>
      <td><p><strong>Optional</strong>: Renames the "Bundle" terminology in the governance UI (for example, "deliverable").</p></td>
    </tr>

    <tr>
      <td><p><code>govern.policy</code></p></td>
      <td><p><strong>Optional</strong>: Renames the "Policy" terminology in the governance UI (for example, "QC plan").</p></td>
    </tr>

    <tr>
      <td><p><code>helpContentUrl</code></p></td>
      <td><p>The URL of the help content.</p></td>
    </tr>

    <tr>
      <td><p><code>hideAddProjectAction</code></p></td>
      <td><p><code>True</code> to hide the <strong>Add Project</strong> button.</p></td>
    </tr>

    <tr>
      <td><p><code>hidePopularProjects</code></p></td>
      <td><p><code>True</code> to hide the list of popular Projects.</p></td>
    </tr>

    <tr>
      <td><p><code>hideDownloadDominoCli</code></p></td>
      <td><p><code>True</code> to hide the Domino client download link.</p></td>
    </tr>

    <tr>
      <td><p><code>hideLearnMoreOnFile</code></p></td>
      <td><p><code>True</code> to hide learn more on file.</p></td>
    </tr>

    <tr>
      <td><p><code>hideMarketingDisclaimer</code></p></td>
      <td><p><code>True</code> to hide the marketing disclaimer.</p></td>
    </tr>

    <tr>
      <td><p><code>pageFooter</code></p></td>
      <td><p>The custom HTML that you want showing just above the page footer.</p></td>
    </tr>

    <tr>
      <td><p><code>showSupportButton</code></p></td>
      <td><p><code>True</code> to show the <strong>Support</strong> button.</p></td>
    </tr>

    <tr>
      <td colSpan="2"><p><em>Git security</em></p></td>
    </tr>

    <tr>
      <td><p><code>gitCredentialsDescription</code></p></td>
      <td><p>A description to show in the Git credentials configuration window.</p></td>
    </tr>

    <tr>
      <td><p><code>hideGitSshKey</code></p></td>
      <td><p><code>True</code> to hide the SSH key in Git configurations.</p></td>
    </tr>

    <tr>
      <td colSpan="2"><p><em>Project visibility</em></p></td>
    </tr>

    <tr>
      <td><p><code>hidePopularProjects</code></p></td>
      <td><p><code>True</code> to hide the list of popular projects.</p></td>
    </tr>

    <tr>
      <td><p><code>hidePublicProjects</code></p></td>
      <td><p><code>True</code> to hide the list of public Projects.</p></td>
    </tr>

    <tr>
      <td><p><code>hideSearchableProjects</code></p></td>
      <td><p><code>True</code> to hide the list of searchable Projects.</p></td>
    </tr>

    <tr>
      <td><p><code>hideSuggestedProjects</code></p></td>
      <td><p><code>True</code> to hide the list of suggested Projects.</p></td>
    </tr>

    <tr>
      <td><p><code>hideLearnMoreOnFile</code></p></td>
      <td><p><code>True</code> to hide "Learn more" on file.</p></td>
    </tr>

    <tr>
      <td><p><code>errorPageContactEmail</code></p></td>
      <td><p>The contact email to be used in error pages.</p></td>
    </tr>

    <tr>
      <td><p><code>appName</code></p></td>
      <td><p>The application name (such as Domino).</p></td>
    </tr>

    <tr>
      <td><p><code>pageFooter</code></p></td>
      <td><p>The custom HTML shown just above the page footer.</p></td>
    </tr>

    <tr>
      <td><p><code>showSupportButton</code></p></td>
      <td><p><code>True</code> to show the <strong>Support</strong> button.</p></td>
    </tr>

    <tr>
      <td><p><code>supportEmail</code></p></td>
      <td><p>The support email address.</p></td>
    </tr>

    <tr>
      <td><p><code>supportUrl</code></p></td>
      <td><p>The support page URL.</p></td>
    </tr>

    <tr>
      <td><p><code>pdfTemplateUrl</code></p></td>
      <td><p>The PDF template URL.</p></td>
    </tr>

    <tr>
      <td><p><code>pdfAppName</code></p></td>
      <td><p>The title for the PDF template.</p></td>
    </tr>
  </tbody>
</table>

**Example**

```json theme={null}
{
  "appLogo": "https://example.datascience.org/sku_setup/logo/for-light-backgrounds/example_logo_blue.png",
  "appLogoBgColor": "#2DEB5E",
  "appName": "My Data Science Platform",
  "appURL" : "https://examples.data.org/app/",
  "defaultProjectName": "my-datascience-project",
  "errorPageContactEmail": "admin@example.datascience.org",
  "favicon": "https://example.datascience.org/favicon.ico",
  "gitCredentialsDescription": "My customized Git credentials description.",
  "govern": {
    "bundle": "deliverable",
    "policy": "QC plan"
  },
  "helpContentUrl": "https://help.example.datascience.org",
  "hideAddProjectAction": false,
  "hideDownloadDominoCli": false,
  "hideGitSshKey": false,
  "hideLearnMoreOnFile": false,
  "hideMarketingDisclaimer": false,
  "hidePopularProjects": false,
  "hidePublicProjects": false,
  "hideSearchableProjects": false,
  "hideSuggestedProjects": false,
  "pageFooter": "<div style='width:100%; height: 50px; background-color: black; color: white;text-align: center;'>Example Page footer</div>",
  "showSupportButton": true,
  "supportEmail": "support@example.datascience.org",
  "supportUrl": "https://example.datascience.org/support/",
  "pdfTemplateUrl": "https://example.com/?export=download_link",
  "pdfAppName": "My Data Science Platform PDF title"
}
```