Changing your theme

Mattermost can recolor its whole interface, per account. Your choice follows you to every device you sign in on.

Open theme settings

Click the Settings gear (top-right, near the search box) → Display → Theme. You can also click your profile picture → Settings.

Built-in themes

Mattermost ships five: Denim, Sapphire, Quartz (light), Indigo, and Onyx (dark). Click one, then press Save at the bottom of the Theme section.

If the Save button seems to vanish: it sits at the bottom of the expanded Theme section, and that section can collapse when you click elsewhere. Click your chosen theme again and the Save / Cancel row reappears — scroll down inside the settings window if you don’t see it.

Ready-made NUILab themes

Coming from Slack and want the familiar look — or want a preset we’ve already tuned? Paste one of the strings below:

1. Settings → Display → Theme
2. Choose Custom Theme
3. Open Import theme colors
4. Paste a string from below, then Save

Slack — Dark

{"type":"custom","sidebarBg":"#1a1d21","sidebarText":"#cbcccd","sidebarUnreadText":"#ffffff","sidebarTextHoverBg":"#27292d","sidebarTextActiveBorder":"#1164a3","sidebarTextActiveColor":"#ffffff","sidebarHeaderBg":"#19171d","sidebarHeaderTextColor":"#ffffff","sidebarTeamBarBg":"#121016","onlineIndicator":"#2eb67d","awayIndicator":"#ecb22e","dndIndicator":"#e01e5a","mentionBg":"#cd2553","mentionBj":"#cd2553","mentionColor":"#ffffff","centerChannelBg":"#1a1d21","centerChannelColor":"#d1d2d3","newMessageSeparator":"#e01e5a","linkColor":"#1d9bd1","buttonBg":"#007a5a","buttonColor":"#ffffff","errorTextColor":"#e01e5a","mentionHighlightBg":"#4a3c1c","mentionHighlightLink":"#ecb22e","codeTheme":"monokai"}

Slack — Light (Aubergine)

{"type":"custom","sidebarBg":"#3f0e40","sidebarText":"#cbc1cb","sidebarUnreadText":"#ffffff","sidebarTextHoverBg":"#350d36","sidebarTextActiveBorder":"#1264a3","sidebarTextActiveColor":"#ffffff","sidebarHeaderBg":"#350d36","sidebarHeaderTextColor":"#ffffff","sidebarTeamBarBg":"#2b0a2c","onlineIndicator":"#2eb67d","awayIndicator":"#ecb22e","dndIndicator":"#e01e5a","mentionBg":"#cd2553","mentionBj":"#cd2553","mentionColor":"#ffffff","centerChannelBg":"#ffffff","centerChannelColor":"#1d1c1d","newMessageSeparator":"#e01e5a","linkColor":"#1264a3","buttonBg":"#007a5a","buttonColor":"#ffffff","errorTextColor":"#e01e5a","mentionHighlightBg":"#fbf4d6","mentionHighlightLink":"#1264a3","codeTheme":"github"}

Navy Amber (navy + gold)

{"type":"custom","sidebarBg":"#0a1622","sidebarText":"#c9b98f","sidebarUnreadText":"#f5c96a","sidebarTextHoverBg":"#14263a","sidebarTextActiveBorder":"#82aaff","sidebarTextActiveColor":"#ffe9b0","sidebarHeaderBg":"#0d1b2a","sidebarHeaderTextColor":"#f5c96a","sidebarTeamBarBg":"#071019","onlineIndicator":"#a3d9a5","awayIndicator":"#ffcb6b","dndIndicator":"#f07178","mentionBg":"#82aaff","mentionBj":"#82aaff","mentionColor":"#0d1b2a","centerChannelBg":"#0d1b2a","centerChannelColor":"#e6d6ad","newMessageSeparator":"#f5c96a","linkColor":"#82aaff","buttonBg":"#f5c96a","buttonColor":"#0d1b2a","errorTextColor":"#f07178","mentionHighlightBg":"#33507a","mentionHighlightLink":"#ffcb6b","codeTheme":"solarized-dark"}

Build your own

Under Custom Theme you can hand-pick every color — sidebar, message area, links and buttons, mention highlights, and the code-block style — with the color pickers, then Save. The Import/Export control there also lets you copy a theme out to share it (that’s exactly how the strings above were made).

Official documentation

• Customize your Mattermost theme (opens in new tab)
• Mattermost documentation home (opens in new tab)