Settings
The settings for the People Hub web part are organized into four sections:
- General
- Directory
- Tree
- Advanced
Below is a detailed description of each section and its configurable options.
- 1. General
- 2. Directory
- 3. Tree
- 4. Advanced
| Setting | Description |
|---|---|
| Data Source | Select the source of the data to be displayed. You can choose between SharePoint User Profiles or Microsoft Graph. Microsoft Graph is recommended for faster performance and immediate profile updates. For cloud-only organizations, Azure Active Directory data is accessed via SharePoint User Profile Service (legacy) or the preferred Microsoft Graph Service. If Graph access isn't approved, use SharePoint Search Service temporarily, noting it may take up to 5 days to re-index user details. |
| Top of Org Browser / Chart | Select the user who will be at the top of the organizational chart or browser. The Top of Org Browser / Chart field is mandatory for the People Hub web part to properly generate and display the organizational tree. This field specifies the user who will be positioned at the top of the organizational chart. Without this information, the People Hub web part cannot construct the hierarchical structure of the organization. |
| Hide users if they don't have... | Select filters to hide users who don't have specific attributes like a manager. |
| Default Tab | Choose which tab should be the default view when the People Hub loads. |
| Webpart Height | Set the height of the web part in pixels. |
| Setting | Description |
|---|---|
| Enabled | Toggle to enable or disable the Directory view. |
| Fields to Show | Select the fields to be displayed in the directory. |
| Display Mode | Choose the display mode for the directory. |
| Disable CSV Export | Toggle to enable or disable the option to export the directory data to CSV. |
| Lazy Loading Enabled | Toggle this setting to enable or disable lazy loading of directory entries. Enabling this feature is particularly beneficial for large organizations with many users, as it dynamically loads users as you scroll through the directory. |
| Office Location Finder URL | This field specifies the URL where the Sprocket Location Finder web part is located. When this URL is provided, clicking on an office location in the directory will navigate to the specified page, where the Location Finder web part will display the clicked user's location information using query string parameters. Please visit Location Finder section to see detailed usage. |
note
The Top of Org Browser / Chart field is mandatory for the People Hub web part to properly generate and display the organizational tree. This field specifies the user who will be positioned at the top of the organizational chart. Without this information, the People Hub web part cannot construct the hierarchical structure of the organization.
| Setting | Description |
|---|---|
| Organization Browser | Toggle to enable or disable the Organization Browser. |
| Organization Chart | Toggle to enable or disable the Organization Chart. |
| Columns | This setting controls the number of columns used to display the Organization Browser. You can adjust it to fit more or fewer items horizontally. |
| Speed Dials |  Select which action buttons to display in the speed dial section of the Organization Browser. These could include options like Email, Teams Chat, Phone, Profile, Office, or Link. |
| Sort Order | Choose the criteria used to sort the Organization Chart and Organization Browser. Note that this setting does not override the organizational hierarchy but instead sorts users within the same reporting level. |
| Scroll Up On Click | Enabling this setting makes the Organization Browser scroll to the top when selecting users, improving the navigation experience, especially in cases of long hierarchical depths or when using a smaller browser screen. |
| Data Report Depth | This setting determines the number of hierarchical levels displayed in the organizational report. Setting this value to 0 will show all levels, providing a comprehensive view of the organization’s structure. Alternatively, you can set a specific report depth to display only a certain portion of the organizational hierarchy. |
| Expanded Levels | This setting controls the initial number of hierarchical levels expanded by default when the organizational chart is first loaded. You can specify how many levels are visible without the user needing to manually expand the chart. |
| Setting | Description |
|---|---|
| Cache Enabled | When toggled, this setting caches user data for 2 minutes, which can improve performance in organizations with a large number of users. However, note that the data may be stale for up to 2 minutes when this is enabled. |
| Enable Extended Graph Query | This setting allows you to enable advanced filtering by setting the ConsistencyLevel header to "eventual" and enabling the count parameter in queries. This can retrieve additional properties and apply extended filtering. For more details, refer to the Microsoft Graph documentation on advanced queries. |
| Disable Link to Delve | This setting disables the navigation to the user's Delve profile when a user is clicked in the Organization Browser. Toggle this on if you do not want users to be redirected to Delve. |
| Append QueryString of Selected User | When this setting is enabled, clicking on a user in the directory will append the selected user's position in the Organization Browser or Org Chart to the URL query string. This makes it easy to copy and share the specific user's location in the hierarchy. |
| Profile Pictures Source | Select the source for user profile pictures. This can be set to "SharePoint" or other available options based on your organization’s setup. |
| Assistant Field Name | Specify the field name in Active Directory (AD) or a SharePoint list that designates a user as an assistant. This corresponds to an attribute in the Microsoft Graph API. If the value is set to 'true', the user is displayed as an assistant to the defined manager in organization browser view. |
| Data Filter (Graph DataSource) | Use this setting to filter user data using OData $filter. For example, you can filter by department using a query like department eq 'Finance' to display only users from the Finance department. |
| Custom Overrides | Advanced users can add custom overrides to further adjust the behavior and appearance of the People Hub web part. For details on how to use custom overrides, please visit field section of the People Hub documentation. |
important
Specific usage of $filter and the $search query parameter is supported only when you use the ConsistencyLevel header set to eventual and $count. For more information, see Advanced query capabilities on Azure AD directory objects.