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:
-
Log in as a System Admin.
-
Go to the System Console (☰ menu > System Console).
-
Navigate to Site Configuration > Custom Branding.
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.
-
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.
Comments
Article is closed for comments.