Employee Directory

This Employee Directory WebPart displays all your Employees as a Directory list with predefined filters from the user profile store

Using the UserProfileStore to build an Employee Directory list with filter options.


WebPart Properties
Property NameDescription
FieldTemplate Define Fields to display and if necessary, rename the Title column with a pipe “|” a “!” will exclude the field from displaying, but makes the value available to filter.
Example: id;Title|Object;
Specials: fieldname=filter, sets the field to be a clickable filter to send to other Webparts.
=photo, users the Url field to display the User Photo
=userdetails, sets the current column to have a details dialog function to show more details.
using search enable disable (search reduce API calls, but not all fields are available by default)
A-Z Fieldname enter a title (altered) column name to link the A-Z Filter to
Filter fields define searchboxes to filter columns.
Example: FieldName1;@FieldName2 this will create a normal text input box for list column FieldName1 and a dropdown box for list column name FieldName2.
Show only Search results Will only show a searchbox and filter the loaded data (shows only the results)
Show search box enable / disable search box
Alternate row color set an alternate row color
Picture source Outlook, userphotos (default)
enable Export to Excel enable disable
Options -
User Details
FieldTemplate Use HTML and CSS to create a userDetail FieldTemplate. Use curly brackets surrounding user profile properties, to show it's values.
Example: {FirstName}
Table CSS
Header CSS Style the table header row with CSS
Header Column CSS Style the table header column with CSS
Filter fields CSS Style the filter fields section with CSS
A-Z Container CSS Style the A-Z Container with CSS
A-Z Items CSS Style the A-Z Items with CSS
A-Z Items (Active) CSS Style the active A-Z Items with CSS
Filter fields CSS A-Z Items (available letters) CSSStyle the available A-Z Items with CSS
Buttons CSS Style the filter fields section with CSS
Custom CSS Style the buttons (Export, Clear Filters) with CSS
Default order by column Nbr. Select the order by column as a number from the FieldTemplate (starts with 0) or enter the column title (altered) name
Sort direction Ascending / Descending
Birthday date Format Format the Date as needed with moments.js
Hiredate date Format Format the Date as needed with moments.js
Image Width (px) set the photo image with
Default page length to set the default item count each page.
Refinement filtering Set the search query refinement filter.
Exclusion filter Highly flexible Filter to exclude list items from view.
Cache retention Time (Minutes) Set the Cache duration in Minutes. Set it to “0” to disable the Cache.
License Key Please enter your Paypal "Profile ID" or "Automatic payment ID" to unlock your WebPart. (Format: I-1A11SSBB2241)

Get a license

We offer different kinds of license

  • a PayPal subscription
  • a conservative invoice for a defined time period

  • Office 365


    Select your seats count (All active accounts having access to your tenant)
    If your seats count is over 2499, please request an Offer!

    SharePoint URL*
    Request an Offer

    Post a comment

    peter behler
    05/31/2019 19:38
    How do you display an email address and not the icon. I tried an old hack of WorkEmail/plain but doesn't seem to work.
    05/31/2019 19:54
    Hello Peter,

    within the WebPart property Field Tempalte, the WorkEmail field is by default set as: WorkEmail=mailiconto|Work e-mail
    To only display the e-mail as text, use the following property field string: WorkEmail=text|Work e-mail
    And to have a mailto link included, use the following setting: WorkEmail=mailto|Work e-mail
    Marty Trionfo
    03/06/2020 19:06
    Hi. Are there instructions available for the Exclusions syntax? I am familiar with the on-prem version (SP2010) so would like to use something like "Lastname NOT IN ('Temp', 'Test', 'Intern', etc.)" without having to list complete usernames or email addresses.
    Thank you.

    03/09/2020 10:59

    we have attached a small documentation about the exclusion filter: Document
    Marty Trionfo
    03/09/2020 19:06
    Raphael - That doc is a great help and thank you for the quick response!
    03/30/2020 16:06
    If I don't want any information to show, until the user selects an option, either a letter or a department, can this be done?
    04/01/2020 13:28

    this feature is currently not implemented.
    We have set a note for the next release.
    04/03/2020 14:04
    Raphael, is there a timeline for the next release?
    04/08/2020 11:17

    there is currently no timeline for the next release date.
    If we find some free time, we are looking into your requested feature and get back to you by email.
    Martin Spittau Dupont
    05/05/2020 12:42
    We are having some issues when loading the users, it seems that it only load a "subset" of users and not all of them (as of now it seems to be that it only loads around 500 users).
    We have no exclusion filters enabled in the webpart.
    Jason Brewington
    05/12/2020 14:07
    Having the same issue Martin Spittau Dupont is having. Only 500 employees showing and no Exclusion filter is set.
    05/12/2020 14:09
    Martin, Jason,

    we have released a new version on 11th of may, which is addressing this issue.
    Please update to the most recent version.
    Jason Brewingtong
    05/12/2020 15:13
    Updated to the latest version but still only getting 500 employees.
    05/12/2020 18:43

    please clear the web part cache. This will do the trick to get the new results loaded by SharePoint.
    Otherwise you can wait until the cache expires (default: 240 minutes)
    06/26/2020 16:20
    Hey.. I am testing the app.. and I added some more fields to the field template, but I get an error for them.... they are Title, Manager & Division.. The error says "Undefined" for every staff member. How do I fix this? thx
    06/26/2020 16:26

    the default settings is using fast search to return from search database.
    There are just a junk of fields available by this mechanism by default. But you can add them in your search schema.
    It will take a couple of days until the database is updated. It's not possible to trigger this crawl externally..

    If you are having not much accounts / profiles (less than 200), you can disable the fast search option and crawl thru all the profiles and get it's property values.
    This will generate a lot of request's against sharepoint and can start throttling your account. This is the point, we will active the cache inside the web part properties (Cache retention time).

    But for production is is recommanded to use the fast search function and implement all necessary fields into your search schema.
    08/07/2020 20:09
    Can you tell me what field name to use to display the Job Title in the list view. I've tried "Job Title", "Title", "JobTitle", "SPS-JobTitle" and the results display undefined.
    Jason Brewington
    08/09/2020 18:57
    I there a way to have the Directory automatically start in alphabetical order? We can click on the name field and it sorts it in order but users want it to start this way.
    08/10/2020 06:51

    please use: JobTitle as the property to receive SPS-JobTitle value.
    If you like to extend the amount of available fields, please modify the search schema with additional refinablestring or refinabledate values mapped to properties.
    Admin panel -> SharePoint ->More features -> Search - > Manage Search Schema.
    User a unused Managed Property called RefinableString / RefinableDate and map a crawled property to. After a couple of days, this values are also available in your table view.
    08/10/2020 06:52

    yes there is a way to do that.
    Please have a look at the "Default order by column Nbr. or Fieldname" property and select the column to order by default.
    10/28/2020 17:52
    In March, I had asked this question, "If I don't want any information to show, until the user selects an option, either a letter or a department, can this be done?". Is this possible in the newer releases?
    10/29/2020 09:59

    please update to the most recent version.
    the new property: "Show only Search result" will display items found by the general searchbox over all fields.
    Eric Stepek
    01/11/2021 17:42
    In the staff directory, I'm displaying the PreferredName column but want to use the Last Name as the A-Z choice and sorting. The Last Name will not be displayed so I have it as !LastName; in the FieldTemplate at the top and use LastName as the A-Z FieldName and LastName in the Sorting default order field. The A-Z is grayed out and sorting isn't working either by last name either.
    01/11/2021 18:49

    we have updated the web part with that additional function so A-Z filter and sort by a hidden field configured within the field template.
    Please update to the most recent version.
    Eric Stepek
    01/12/2021 19:15
    Added the Staff Web Part on a Basic Modern Page. When opening the page on a mobile device (like my Iphone), the page scrolls vertically, but not horizontally. Only the first couple columns display. Is this a "modern" page bug or am I missing a configuration item?
    01/15/2021 16:07

    if you are using card view the web part should float, but the list view can not float in case of the title row section.
    You can set the web part by default into cardview by adding the optionstring "setcardview=1|" into the web part property options.
    Jason Brewington
    03/04/2021 15:06
    We have multiple domains in one tenant. We are wondering if it is possible to have the directory filter out all employees other than who is in your domain but still be able to search for other users in another domain.
    03/05/2021 12:52

    unfortunately there is currently no option to filter out other domains than the current user is logged in, but make them searchable.
    I am also not sure, if this would be possible.
    It looks like a more exotic request. If you need this feature we can have a look into this within a screen sharing session, but need to create a paid customer request for this case.
    John Williamson
    07/21/2021 18:38
    We have installed the software and are not getting the correct employee photos. How can we resolve this issue?
    Raphael Bloch
    07/22/2021 06:26

    it depends on how the User Profiles are created and if these accounts ever logged into SharePoint.
    Default settings should work in most case and if there are no photos available, we need to check the profiles within the User Profile Store.

    Please let me know if you need a screensharing session to look into this issue together directlo on your tenant.
    We also could install the Birthday Reminder web part and enable some features to enshure all your accounts to make them knowed by SharePoint if the farm is not yet live.