> ## Documentation Index
> Fetch the complete documentation index at: https://langchain-5e9cc07a-preview-docsby-1791319236-3be7a15.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Customize the UI

> Customize your LangSmith self-hosted deployment.

Self-hosted LangSmith deployments allow for some UI customization.

## Set a custom logo

For self-hosted deployments, you can replace the LangSmith logo with your own. The logo appears in the navigation sidebar and on error screens, next to the LangSmith wordmark.

Set `config.customLogo` in your Helm values:

```yaml Helm theme={null}
config:
  customLogo:
    enabled: true
    logoUrl: "https://example.com/logo.svg"
```

`logoUrl` accepts a PNG, JPG, or SVG. Data URIs are rejected.

### Use a different logo for light and dark mode

```yaml Helm theme={null}
config:
  customLogo:
    enabled: true
    lightModeLogoUrl: "https://example.com/logo-dark-text.svg"
    darkModeLogoUrl: "https://example.com/logo-white-text.svg"
```

Each name refers to the scheme the logo appears in. When you set only one value, LangSmith uses it in both schemes. Requires Helm chart version 0.17.0-rc.38 or later.

### Serve a logo from a file

Each logo value also accepts a root-relative path, such as `/logos/acme.svg`. Use a path when the browser cannot reach an external host. LangSmith requests the path from its own origin, so the file must exist inside the frontend container.

To mount a logo file:

1. Store the image in a ConfigMap. The filename becomes the last segment of the URL:

   ```bash theme={null}
   kubectl create configmap langsmith-custom-logo \
     --from-file=acme.svg=./your-logo.svg \
     -n <your-namespace>
   ```

2. Mount the ConfigMap into the frontend pod and point `logoUrl` at the path:

   ```yaml Helm theme={null}
   config:
     customLogo:
       enabled: true
       logoUrl: "/logos/acme.svg"

   frontend:
     deployment:
       volumes:
         - name: custom-logo
           configMap:
             name: langsmith-custom-logo
       volumeMounts:
         - name: custom-logo
           mountPath: /usr/share/nginx/html/build/logos
           readOnly: true
   ```

3. Upgrade the release, then confirm the file is served:

   ```bash theme={null}
   curl -sI https://<your-langsmith-host>/logos/acme.svg
   ```

   A `content-type` of `image/svg+xml` confirms the logo is in place. A missing file returns HTTP 200 with the application's HTML rather than a 404, so check the content type and not the status code.

<Note>
  When your values already set `frontend.deployment.volumes` or `frontend.deployment.volumeMounts`, append to those lists. Replacing them removes mounts that other settings depend on.
</Note>

When you serve LangSmith under a base path, include it in the value: `/<base-path>/logos/acme.svg`. For the full list of Helm values, see [Environment variables](/langsmith/self-host-environment-variables).

## Set a custom error support message

By default, error messages in LangSmith direct users to the [Support Portal](https://support.langchain.com). You can replace this with your own support contact information.

When set, all error and support messages throughout the UI will display your custom text instead of the default LangChain support email.

<Note>
  The custom message is rendered as **plain text** only. HTML tags will not be interpreted and will display as literal text.
</Note>

```yaml Helm theme={null}
config:
  customErrorSupportMessage: "For help, contact your internal IT team at helpdesk@example.com"
```

To revert to the default behavior, remove the setting or set it to an empty string.

***

<div className="source-links">
  <Callout icon="terminal-2">
    [Connect these docs](/use-these-docs) to your agent of choice via MCP for real-time answers.
  </Callout>

  <Callout icon="edit">
    [Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/langsmith/self-host-ui-customization.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>
</div>