Configuring the Directory View
Tagged With: Views, Configuration
Last Updated: July 2024
The directory view defines what is shown to the user as they are browsing, searching, or refining the users of the directory. Once they click on a user, they’re taken to the profile view. Edit the web part and navigate to page 3 of the web part property pane to configure the directory view.
On this page:
Web Part Title
The web part title option allows you to define a title to be displayed above the web part. Additionally, if the “Hide title automatically” option is enabled and no users are being displayed, the title is automatically hidden. This is useful for scenarios like automated Birthday or Anniversary views, where the webpart will essentially hide itself if there are no users to celebrate.
Display Fields
Defining the display fields controls which properties from the user profile are displayed. From page 3 of the web part property pane, click the “Display Fields” button to open the field wizard.
NOTE: When using the Tiled Display Format, a maximum of 4 fields are shown in the directory view.
Adding Fields
Click the “New Field” button and select the field to be added.
Select whether the label (field name) should be hidden
Select the field Display Format
Select whether the field should be hidden if empty.
Display Formats
The field’s display format determines how the value is rendered.
Text: The default value for most fields, displays the value in plain text.
Text (Years of Service): Available on Hire Date only, displays the user’s hire date and years of service with the company, eg: “April 1st (7 Years)”.
Inline List: Displays the value of lists, or multi-person fields, eg: Direct Reports, as a comma separated list.
Bulleted List: Displays the value of lists, or multi-person fields, eg: Direct Reports, as a bulleted list.
Person/Person List: Displays the value of person or multi-person fields, eg: Manager, Direct Reports, as a clickable person widget with a photo.
Ordering Fields
Fields are shown in the wizard in the same order they will be shown to users when using the web part. Reorder fields by clicking the up and down arrows.
Deleting Fields
To delete a field, click the trash can icon, and then confirm that you wish to delete the field.
Display Options
Sort By
Identifies the field used to sort the users in the directory. When changing the sort behavior of the web part, reloading the page is required before the changes will be displayed.
Birthday: Sorts by date, excluding year.
Display Name: Sorts by the display name.
First Name: Sorts by the user’s first name.
Hire Date/Anniversary: Sorts by the full hire date, most senior person first.
Last Name: Sorts by the user’s last name.
Format
Identifies the type of display used to show the directory.
List: Traditional list with one row per user, each display field as a column.
Tiled: The recommended way to display the directory. Displays interactive user cards for each user.
Number of Columns
If the Format field is set to Tiled, indicates the number of columns to display.
Items Per Page
Indicates how many users to display per page.
Show Alphabet Soup
Indicates whether the alphabetical filter is displayed across the top of the web part.
Show Page Statistics
Indicates whether statistics around the total number of users should be displayed at the bottom of the web part.
Show Photo
Indicates whether the user’s photo should be shown. Not applicable if the Format field is set to List.
Photo Options
Photo Size
Indicates the size of photo to display (Normal, Large, Extra Large).
Photo Shape
Indicates if the photos should be displayed as Square or Round.
Photo Style
Indicates if the photos should be displayed as they exist in Entra ID (Normal), or converted to Black & White.