---
schema_version: "1"
id: 5bec9eb731e61a83f89f9b97d4a7cc6653335f7d18a660dc6c0b0f5135e30783
title: tsm customize
collection: tableau
version: current
locale: en-us
portal_url: https://docs.salesforce.com/tableau/current/en-us/server/cli_customize.md
canonical_url: https://help.tableau.com/current/server/en-us/cli_customize.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 1e88fd6d86d59977bf16f58cb77ccef1f2ebb8e4dd4a7fa15b342cfffd584fb8
description: Reference for the tsm customize command to brand the Tableau Server browser experience.
---
[Skip to main content](#main-content)

# tsm customize

You can use the `tsm customize` command to customize the look and feel of the Tableau Server client browser experience.

![Tableau Server explore page.](/tableau/current/en-us/server/en-us/Img/custom_namelogo.png)

   
| Logo | Option flag | Minimum size/Maximum size, in pixels | Recommended size, in pixels |
| --- | --- | --- | --- |
| **A** - Window tab logo | cannot be changed | cannot be changed | cannot be changed |
| **B** - Server name | `--server-name` | does not apply | does not apply |
| **C** - Header logo | `--header-logo` | 32 by 32 min, 160 by 160 max | 48 by 48 |
| **Not shown** - Sign in logo | `--signin-logo` | 3000 by 3000 max |   |
| Header logo/Sign in logo | `--logo` | 32 by 32 min, 160 by 160 max | 48 by 48 |
| **Not shown** - Logo shown when navigation pane is minimized | `--compact-logo` | 32 by 32 max | 32 by 32 |

The image files you use should be in GIF, JPEG, or PNG format.

The background colors on the header and sign in page are not the same. If you use the same image for both locations (if you use the `--logo` option, for example) your logo might look different depending on where it appears in the server interface.

As part of your disaster recovery plan, we recommend keeping a backup of the customization image files in a safe location off of the Tableau Server. The image files that you add to Tableau Server will be stored and distributed to other nodes by the Client File Service. However, the files are not stored in a recoverable format. See [Tableau Server Client File Service](https://help.tableau.com/current/server/en-us/server_process_cfs.htm).

### Synopsis

`tsm customize [options] [global options]`

After you run the `customize` command, you must run the following command to apply changes:

`tsm pending-changes apply`

### Options

**Note:** Use the path and image file name cannot include any spaces.

\--compact-logo "<path-to-logo>"

Optional.

Specify a path to the image file that will be displayed when the navigation pane size is minimized. The maximum (and optimal) size is 32 by 32 pixels.

\--header-logo "<path-to-logo>"

Optional.

Specify a path to the image file that will be displayed in the header only.

\--logo "<path-to-logo>"

Optional.

Path to a single image file that will display for both the header and the sign-in window.

\--restore-defaults

Optional.

Reset all customization options to default install state.

\--server-name <server\_name>

Optional.

Server name that appears in the browser tab, tooltips, and messages.

\--signin-logo "<path-to-logo>"

Optional.

Specify a path to the image file that will be displayed for sign-in window only.

## Global options

\-h, --help

Optional.

Show the command help.

\-p, --password <password>

Required, along with `-u` or `--username` if no session is active.

Specify the password for the user specified in `-u` or `--username`.

If the password includes spaces or special characters, enclose it in quotes:

`--password "my password"`

\-s, --server https://<hostname>:8850

Optional.

Use the specified address for Tableau Services Manager. The URL must start with `https`, include port 8850, and use the server name not the IP address. For example `https://<tsm_hostname>:8850`. If no server is specified, `https://<localhost | dnsname>:8850` is assumed.

\--trust-admin-controller-cert

Optional.

Use this flag to trust the self-signed certificate on the TSM controller. For more information about certificate trust and CLI connections, see [Connecting TSM clients](https://help.tableau.com/current/server/en-us/tsm_overview.htm#Connecti).

\-u, --username <user>

Required if no session is active, along with `-p` or `--password`.

Specify a user account. If you do not include this option, the command is run using credentials you signed in with.