The list of Colleagues is a digital address book of all the users on your platform, sorted alphabetically by surname. You can see a profile card with profile information for each user and can select a card to navigate to that user's profile. Depending on your platform's settings, you might be able to follow or message a user via quick action. In the list of colleagues, you can use search or the filters to find your colleagues. 

You can access the Colleagues list from the people icon in the navigation bar. You need "Access Colleague List" permission to see this option and use the Colleagues list.

Search

In the Colleagues list, you can search for a colleague using any information on their profile card. The information on a user's profile card is taken from their profile. By default, the below fields are visible on a profile card if they have been filled out in the user's profile:

• First and last name (fixed position)
• Pronouns (fixed position, if enabled)
• Title (fixed position)
• Department (fixed position)
• Email address (fixed position)
• Phone number (order determined by profile group and field order)

To show more profile fields on a user's profile card in the Colleagues list, you can use the API to set "overview": true for the corresponding profile field. Adding a profile field to the profile card will also make it searchable. The order of new profile fields on the profile card is determined by the profile group and field order, sortOrder and Order.

You can also use the global search to search for colleagues by any information on their profile, not just what is visible on the profile card in the Colleagues list. Just enter your search term and filter by type > Colleagues.

Filter

You can narrow down the Colleagues list by using filters to find specific colleagues based on information you know about them. There are four filters available by default:

• Availability: Shows users who have an active WebSocket connection and have set their status to Available/Online.
• Status: You can choose to view:
  • Following: Users that you follow.
  • Not following: Users that you don't follow.
  • Followers: Users that follow you.
• Department: Shows options populated from the Department field in users' profiles. Colleagues who have no input for this field are listed under N/A.
• Current location: Shows options populated from the Current location field in users' profiles. Colleagues who have no input for this field are listed under N/A

To add more profile field filters to the Colleagues list, you can use the API to set "searchAggregation": true for the corresponding profile field. To change the order of filters, add "searchAggregationOrder": number where 1 is shown first, 2 second, and so on.

Fill users' profile fields, such as Department, Location, Company, Office, from a user directory to ensure all profiles have basic information that is formatted in the same way, as long as this information is available in a centralized company directory. If you want to encourage users to maintain some fields independently to personalize their profile, you could allow them to edit fields such as Hometown, Interests, Projects, About, etc. You can configure the available profile fields with the API.

Below is an example where the Office profile field has been added as a filter option and included on the profile card: