We are looking at this feature as the first candidate to leverage the new ‘properties’ concept that Joram Wilander has been working on.
Configuring custom user properties
In the system console, a new view is proposed under Site Configuration > System properties
. This will house configuration for customizing properties for users, messages, and cards.
Standard properties
Every Mattermost server has as set of standard user properties. These properties cannot be removed.
Profile Image (no visibility options)
Full Name (visibility default: Always show)
Username (visibility default: Always show)
Email (visibility default: Hide when empty)
ID (visibility default: Always hide)
The following configuration is available for standard user properties
Visibility - admins can hide/show the property from user profiles (see below)
Link/unlink SAML or ADLDAP (if setup)
Custom properties
Default custom properties
By default, the following optional properties ship with user profiles. These properties can be removed or edited as needed. Additional properties can also be added here (see ‘Adding a new property’ below).
Nickname
Position
Adding a new custom property
Under the Custom properties section, users can click the Add property
button to add a new property to the system.
Re-ordering custom properties
Each row in the custom properties table can be dragged to re-order. Re-ordering here will change the order properties are displayed in the user profile.
Editing a property
Editing property name
Clicking on the property name in the table enables users to edit the name inline.
Note: User property names must be unique.
Editing property type
Custom properties can be clicked to open up the types menu to change the property type. This menu is searchable.
Editing property options
Admins can set predefined options for a property with Select, and Multi-Select property types. Admins can add and remove options directly in this configuration table.
More settings and actions
Visibility: Choose whether the property shows in user profiles. Available options are:
Always show
Always hide
Hide when empty (default)
Allow new options: Choose whether end users can add new options for the property. This is only available for Select or Multi-Select property types.
Duplicate property: Creates a copy of the property with the same configuration and adds to the bottom of the table. Appends ‘2’ to the end of the property name.
Link to SAML or AD/LDAP: If SAML or ADLDAP are configured on the server, this option will be available and user properties can be linked.
Linking a property to SAML or ADLDAP attribute
If the server is already configured with AD/LDAP or SAML sync, then the menu option to link a property becomes available.
Upon clicking this menu option, a modal opens to link the attribute.
When a value is entered, the attribute is checked and validated with AD/LDAP (or SAML)