Skip to content

Document User Attributes Display Name and Name (v11.8) #9025

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Combs7th wants to merge 4 commits into
base: v11.8-documentation
Choose a base branch
from
+5 −0
Open

Document User Attributes Display Name and Name (v11.8) #9025

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
37957a4
MM-68718: Document Azure Blob Storage as a file storage backend (#8976)
agarciamontoro Jun 11, 2026
eb35cda
docs: clarify ID attribute case sensitivity for AD/LDAP and SAML (#9020)
ewwollesen Jun 11, 2026
5db8287
docs: document User Attributes Display Name and Name (v11.8)
github-actions[bot] Jun 12, 2026
6d8417c
Remove unintended configure changes
Combs7th Jun 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions source/administration-guide/manage/admin/user-attributes.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,8 @@ Add attributes

You can define and manage up to 20 system attributes using the System Console. Each attribute becomes a user profile option users can populate, unless you disable the **Editable by Users** option, available from Mattermost v11. Once you reach the maximum of 20 attributes, you can't create new attributes until you `delete attributes <#manage-attributes>`__ you no longer need.

From Mattermost v11.8, user attributes include both a **Display Name** and a **Name**. The Display Name is the label shown to users and admins in Mattermost. The Name is the internal attribute identifier used in API references and :doc:`attribute-based access control (ABAC) </administration-guide/manage/admin/attribute-based-access-control>` policy expressions. When you create a new user attribute, Mattermost can generate the Name from the Display Name, formatted as a CEL-safe identifier. Saved ABAC policies continue to reference the internal name using ``user.attributes.<name>``.

.. note::

When you disable the **Editable by Users** option for an attribute, only admins can set its value using :ref:`mmctl cpa <administration-guide/manage/mmctl-command-line-tool:mmctl cpa>` commands.
Expand Down Expand Up @@ -121,6 +123,9 @@ Manage attributes

- **Modify**: Select the attribute fields to make inline changes to the attribute's name, type, or values. Select **More** |more-icon| to change a attribute's visibility.

.. note::
From Mattermost v11.8, existing user attributes are backfilled so the Display Name initially matches the Name. If the Display Name is empty or unavailable, Mattermost falls back to showing the Name. Duplicate display names are permitted, but internal names remain unique.

- **Order**: Control the order you want attributes to appear in user profiles by dragging and dropping them in the list.

- **Delete**: Delete attributes you no longer need or want by selecting **More** |more-icon| and selecting **Delete property**.
Expand Down
Loading