How to Change the Site Name and Branding in Mattermost

Problem

When users log into your Mattermost workspace, the default branding still says “Mattermost” — which might not reflect your organization. You want to personalize the site name, description, and logo to better match your team or company identity.

 

Solution

Mattermost lets you easily customize the name, branding text, and logos shown throughout the interface.

To update the site branding:
  1. Log in as a System Admin.

  2. Go to the System Console (☰ menu > System Console).

  3. Navigate to Site Configuration > Custom Branding.

Screenshot 2025-05-30 at 10.47.48 AM.png

Here, you can change:

  • Site Name: This replaces “Mattermost” in the browser tab and sidebar.

  • Site Description: Appears on the login page.

  • Custom Brand Text: Displayed on the top banner.

  • Custom Logo: Upload your company’s logo to replace the Mattermost logo.

  1. After making your changes, click Save.


Example

Setting Example Value
Site Name Acme Workspace
Description Collaboration for Acme Team
Custom Brand Text Welcome to Acme Mattermost
Logo Upload PNG or JPG (min 300x60px)

Tip

You can preview the login page by opening a private/incognito window or logging out.

If you have branding disabled via config.json, these settings won’t take effect until it’s enabled. Make sure "EnableCustomBrand": true is set.

 

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Article is closed for comments.