3.1 KiB
Custom profile fields
{!admin-only.md!}
By default, user profiles show their name, email, date they joined, and when they were last active. You can also add custom profile fields like country of residence, birthday, manager, Twitter handle, and more.
Custom profile fields are always optional, and do not appear in users' profiles until they fill them out.
Zulip supports synchronizing custom profile fields from an external user database such as LDAP or SAML. See the authentication methods documentation for details.
Add a custom profile field
{start_tabs}
{settings_tab|profile-field-settings}
-
Click Add a new profile field.
-
Fill out profile field information as desired, and click Add.
-
In the Labels column, click and drag the vertical dots to reorder the list of custom profile fields.
{end_tabs}
Edit a custom profile field
{start_tabs}
{settings_tab|profile-field-settings}
-
In the Actions column, click the pencil () icon for the profile field you want to edit.
-
Edit profile field information as desired, and click Save changes.
{end_tabs}
Profile field types
Choose the profile field type that's most appropriate for the requested information.
- Date: For dates (e.g., birthdays or work anniversaries).
- Link: For links to websites, including company-internal pages.
- External account: For linking to an account on GitHub, X (Twitter), etc.
- List of options: A dropdown with a list of predefined options (e.g., office location).
- Pronouns: What pronouns should people use to refer to the user? Pronouns are displayed in user mention autocomplete suggestions.
- Text (long): For multiline responses (e.g., a user's intro message).
- Text (short): For one-line responses up to 50 characters (e.g., team name or role in your organization).
- Users: For selecting one or more users (e.g., manager or direct reports).
Display custom fields on user card
Organizations may find it useful to display additional fields on the user card, such as pronouns, GitHub username, job title, team, etc.
All field types other than "Long text" or "Person" have a checkbox option that controls whether to display a custom field on the user card. There's a limit to the number of custom profile fields that can be displayed at a time. If the maximum number of fields is already selected, all unselected checkboxes will be disabled.
{start_tabs}
{settings_tab|profile-field-settings}
-
In the Actions column, click the pencil () icon for the profile field you want to edit.
-
Toggle Display on user card.
-
Click Save changes.
!!! tip ""
You can also choose which custom profile fields will be displayed by toggling
the checkboxes in the **Card** column of the **Custom profile fields** table.
{end_tabs}