Manage Profile Settings

Available in Mattermost Free and Starter subscription plans. Available for Mattermost Cloud deployments. Available for Mattermost Self-Hosted deployments.

You can configure your profile and security preferences by selecting Profile from your Avatar in the Global Header.

In Mattermost v6.0, Account Settings have moved.

  • Access Profile and Security settings from your Avatar in the Global Header.

  • Access Notifications, Display, Sidebar, and Advanced Settings by selecting the Gear Select the Gear icon to open the Settings dialog. icon in the Global Header.

Profile

Settings to configure name, username, nickname, email, and profile picture.

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 identifiers 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. Username must begin with a letter, and contain between 3 to 22 lowercase characters made up of numbers, letters, and the symbols ‘.’, ‘-‘, and ‘_’.

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 notifications list in Notifications.

Position

Position can be used to describe your role or job title. It appears in the profile popup that shows up when you select a user’s name in the center channel or right-hand sidebar.

Email

Email is used for signing 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 at the top of the channel sidebar next to your name. To change your profile picture, choose Select, then choose an image. For best results, choose an image that’s at least 128 x 128 pixels in size. Supported image formats include: BMP, JPG, JPEG, and PNG. The GIF file format is not supported.

Security

Settings to configure your password, view access history, and view or logout of active sessions.

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 require a phone-based passcode in addition to your password when signing in.

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

  1. Select the Add MFA to your account button.

  2. Use Google Authenticator to scan the QR code that appears.

  3. Enter the token generated by Google Authenticator, then select 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. Select the Add MFA to your account button. You should see a Secret Key below the QR code.

  2. Open Google Authenticator.

  3. Select the + button, then select Manual Entry.

  4. Enter an account name.

  5. Enter the Secret Key from Mattermost into the Key field in Google Authenticator, then select Save.

  6. In Mattermost, enter the token generated by Google Authenticator, then select 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 select 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. Select Logout on an active session if you want to revoke automatic login privileges for a specific browser or device. Select More Info to view details on browser and operating system.