Account Settings¶

Full Name¶

Full names appear in the Direct Messages member list and team management modal. By default, you will receive mention notifications when someone types your first name. Entering a full name is optional.

Username¶

Usernames are unique identifers appearing next to all posts. Pick something easy for teammates to recognize and recall. By default, you will receive mention notifications when someone types your username. In order to maintain message integrity, changing your username does not update @mentions in messages already posted.

Nickname¶

Nicknames appear in the Direct Messages member list and team management modal. You will not receive mention notifications when someone types your nickname unless you add it to the Words That Trigger Mentions in Account Settings > Notifications.

Email¶

Email is used for sign-in, notifications, and password reset. Email requires verification if changed. If you are signing in using a single sign-on service, the email field is not editable and you will receive email notifications to the email you used to sign up to your SSO service.

Profile Picture¶

Profile pictures appear next to all posts and in the top of the channels pane next to your name. All users have a generic profile picture when they sign up for an account. Edit your profile picture by clicking Select and then choosing a picture in either JPG or PNG format that’s at least 128px wide and 128px high. For best results, choose an image that is square with the subject of interest centered. If you edit your profile picture, all past posts will appear with the new picture.

Password¶

You may change your password if you’ve logged in by email. If you are signing in using a single sign-on service, the password field is not editable, and you must access your SSO service’s account settings to update your password.

Multi-Factor Authentication¶

When this option is available you can requires a phone-based passcode in addition your password for sign-in.

To enable, download Google Authenticator from iTunes or Google Play for your phone, then:

1. Click the Add MFA to your account button.
2. Use Google Authenticator to scan the QR code that appears.
3. Type in the Token generated by Google Authenticator and click Save.

In future, you will be asked to enter a passcode from Google Authenticator in addition to your password on login.

If you are unable to scan the QR code, you can:

1. Click the Add MFA to your account button, and you should see a Secret Key below the QR code.
2. Open Google Authenticator.
3. Click the + button, and select Manual Entry.
4. Enter an account name.
5. Enter the Secret Key from Mattermost into the Key field in Google Authenticator, and save.
6. In Mattermost, type the token generated by Google Authenticator and click Save.

Sign-in Method¶

This option allows you to switch your sign-in method from email/password to a single-sign-on option, and back again.

For example, if AD/LDAP single-sign-on is enabled, users can click a “Switch to using AD/LDAP” button and the enter their AD/LDAP credentials to switch sign-in over to AD/LDAP. They also need to enter the password for their email account to verify their existing credentials. Following the change, users receive an email to confirm the action.

View Access History¶

Access History displays a chronological list of the last 20 login and logout attempts, channel creations and deletions, account settings changes, or channel setting modifications made on your account. The details of the Session ID (unique identifier for each Mattermost browser session) and IP Address of the action is recorded for audit log purposes.

View and Logout of Active Sessions¶

Sessions are created when you log in with your email and password to a new browser on a device. Sessions let you use Mattermost for up to 30 days without having to log in again. Click Logout on an active session if you want to revoke automatic login privileges for a specific browser or device. Click More Info to view details on browser and operating system.

Desktop Notifications¶

Desktop notifications appear in the corner of your main monitor when there is activity in Mattermost.

Email Notifications¶

Email notifications are sent for mentions and direct messages after you’ve been offline for more than 60 seconds or away from Mattermost for more than 5 minutes. Change the email where notifications are sent in Account Settings > General > Email.

If your System Administrator has enabled Email Batching, you will have additional options under this settings to select how often email notifications will be sent. All notifications received over this time period are combined and sent in a single email.

Send Mobile Push Notifications¶

Push notifications can be sent to your mobile device if you have the Android or iOS app installed. You can choose the type of activity that will send a notification. By default, push notifications are sent “For mentions and direct messages”. If push notifications are sent “Never”, the Mattermost setting to trigger push notifications depending on your status is hidden. If your System Administrator has not set up push notifications, this setting will be disabled.

If you are actively viewing a channel (public, private, or direct message) on desktop or web, no push notifications will be sent for that channel. If a notification is viewed on desktop or web, the lockscreen notification will clear on Android, and on iOS the badge on the Mattermost app icon will decrement accordingly.

Trigger Mobile Push Notifications When¶

You can also choose when to send push notifications depending on your status. By default, push notifications are sent if your status is “Online, away or offline”. If “Send Mobile Push Notifications” is set as “Never”, this setting is hidden. If your System Administrator has not set up push notifications, this setting will be disabled.

Words That Trigger Mentions¶

By default, you will receive mention notifications from your non-case sensitive username, mentioned @username and @channel. Customize the words that trigger mentions by typing them in the input box. This is useful if you want to be notified of all posts on a certain topic, for example, “marketing”.

Reply Notifications¶

In addition to Words that Trigger Mentions, this setting allows you to receive mention notifications when someone replies to a thread that you started or participated in. You are considered to start a thread when you post a message to which other members of your team reply. You are considered to participate in a thread when you post a message using the reply button in an already existing thread.

Theme¶

Select Theme Colors to select from four standard themes designed by the Mattermost team. To make custom adjustments on the four standard theme colours, click a standard theme and then select Custom Theme to load the standard theme into the custom theme color selectors.

Select Custom Theme to customize your theme colors and share them with others by copying and pasting theme vectors into the input box. Observe a live preview as you customize theme colors and then click Save to confirm your changes. Discard your changes by clicking Cancel or by exiting the settings modal and clicking Yes, Discard.

In Enterprise Edition, if you belong to multiple teams, you can optionally select the checkbox “Apply new theme to all my teams” to have the theme show up across teams. Otherwise, the changes will only apply to the current team.

Learn more about the custom theme color selectors here.

Select Import theme colors from Slack to import a Slack theme. In Slack, go to Preferences > Sidebar Theme and open the custom theme option. From there, copy the theme color vector and then paste it into the Input Slack Theme input box in Mattermost. Any theme settings that are not customizable in Slack will default to the “Mattermost” standard theme settings.

Display Font¶

Select what font is used.

Clock Display¶

Choose a 12-hour or 24-hour time preference that appears on the time stamp for all posts.

Teammate Name Display¶

Configure how names are displayed in Mattermost: nickname, username or full name.

Link Previews¶

Select whether links posted on Mattermost show a preview below them. When “On”, a preview will be shown below links to Youtube Videos and GIF, PNG, JPEG, and BMP files. When “Off”, no preview will be shown. This setting can also be controlled using the slash commands /expand and /collapse.

Message Display¶

Select the formatting for messages in the center channel. “Compact” mode decreases the spacing around posts, collapses link previews, and hides thumbnails so only file names are shown. Some formatting types, such as block quotes and headings, are also reduced in size.

Channel Display Mode¶

Select if the text in the center channel is fixed width and centered, or full width.

Language¶

Select what language Mattermost displays in the user interface. Options include:

• Deutsch - German
• English
• Español - Spanish
• Français - French
• Nederlands - Dutch
• Português (Brasil) - Portuguese
• Pусский - Russian
• 한국어 - Korean
• 中文 (简体) - Simplified Chinese
• 中文 (繁體) - Traditional Chinese
• 日本語 - Japanese

Send Messages on Ctrl+Enter¶

If enabled, press Enter to insert a new line and Ctrl + Enter posts the message. If disabled, Shift + Enter inserts a new line and Enter posts the message.

Enable Post Formatting¶

This setting controls whether post formatting is rendered. When “On”, posts will be rendered with markdown formatting, emoji, autolinked URLs, and line breaks. When “Off”, the raw text will be shown.

Enable Join/Leave Messages (Enterprise Edition)¶

This setting controls whether system messages about users joining or leaving a channel are visible. When On these messages will appear. When Off, these messages will be hidden. If any users are added to or removed from a channel or group, a system message will still be shown even if this setting is Off.

Preview pre-release features¶

Turn on preview features to view them early, ahead of their official release:

• Show markdown preview option in message input box: Turning this on will show a “Preview” option when typing in the text input box. Pressing “Preview” shows what the Markdown formatting in the message looks like before the message is sent.
• Show preview snippet of links below message: Turning this on will show a preview snippet posted below links from select websites.
• Enable the ability to make and receive one-on-one WebRTC calls: Turning this on will allow user to make one-on-one video calls on Chrome, Firefox and Mattermost Desktop Apps inside Mattermost. This feature is only available if WebRTC is enabled on the server. See documentation to learn more.