This guide explains how to install, configure, and use Cloudwell Staff Directory in SharePoint and Teams.
Existing screenshots and videos illustrate earlier interfaces; use the current settings panel for available options. Staff Directory can be used as a SharePoint web part or full-page app, with configuration also available for Teams tabs.
Configure the Staff Directory web part from its settings pane while editing the SharePoint page. Expand a settings group to change its options. Some controls open a separate configuration panel.
The settings groups are Layout, Celebrations, Cards, List, Filter and sort, and Advanced settings. The Cards and List groups appear only when their respective views are enabled.
For a Teams tab, open the tab’s settings to configure the app.
Use Layout settings to control the directory title, paging, initial results, presence, hover cards, exports, actions, and available views.
Show title shows or hides the web part title. It is on by default.
Page size sets how many people appear on each page. The default is 12.
Show page number buttons shows or hides the numbered page buttons. It is on by default.
Show all by default shows people before a search or filter is applied. It is on by default. When it is off, users need to apply a search or filter to see results.
Show presence displays Microsoft 365 presence information. It is on by default and requires the Microsoft Graph Presence.Read.All permission.
Show hover card enables hover cards for people. It is on by default.
Show export actions makes export options, including Excel and CSV, available to users. It is on by default. Review the exported columns and results before distributing a file.
Configure actions selects and orders actions on person cards and list rows. Email, chat, call, and share are selected by default. Call and share options can be configured in the panel.
Default view chooses the initial view: Cards or List. Cards is the default. After changing it, save the page and reopen it to confirm the intended view loads.
Available views chooses which views users can switch between. Cards and List are both enabled by default. Disabling a view also hides its settings group.

Select the celebration types to display: birthday, anniversary, or new hire. None are selected by default. When a type is selected, the related settings become available:
birthday.employeeHireDate.For a custom window, set how far back and ahead to include, in days, weeks, or months. Confirm that the selected birthday and hire-date properties contain data and that the configured window includes the people you expect.

Card layout selects small, medium, or large cards. Large is the default. The Cards settings group appears only when the Cards view is enabled.
Configure card layout chooses and orders the properties shown on the card. Select the properties you need, arrange their order, and review the card preview.
| Card size | Default front fields | Front property limit | Card back |
|---|---|---|---|
| Large | Job title, department, phone, office location, company | 5 | Can be configured |
| Medium | Job title, department, office location | 3 | Can be configured |
| Small | Job title, department | 2 | No back |
Custom properties defined in Advanced settings are available for card configuration. Check profiles with populated and empty fields before publishing.

Large and medium cards can have a back configured for additional profile information. Small cards have no back. Use the card builder to select the properties displayed on the front and back.
Define custom Microsoft Graph user properties and their display labels under Advanced settings → Custom properties before selecting them for cards or lists. Labels control how fields are presented; they do not change the underlying profile data.
Fax number is also supported as a card property. Check that source profiles contain the property before adding it to a layout.
Staff Directory supports clickable email attributes and a phone selector that can include both a main phone number and a mobile number. Phone icons can be shown or hidden.
Configure the available call options and custom person actions to suit how colleagues contact one another. Verify each configured action with a test profile before publishing.
Native sharing is supported on compatible devices. Use the share action offered by the app; the available sharing destinations depend on the device and browser.
Compact mode uses a more compact list layout. It is off by default. The List settings group appears only when the List view is enabled.
Configure list view chooses and orders the list columns. The default columns are job title, department, manager, and office location.
Select the columns required by your organization and arrange their display order. Custom properties defined in Advanced settings are also available for list configuration.

Sort by sorts people by first name, last name, or display name. Last name is the default.
Initials filter by chooses which name field the letter filter uses: first name, last name, or display name. Last name is the default. Choose Display Name when colleagues commonly search by a preferred or displayed name.
Show search shows or hides text search. It is on by default. Search includes first name, last name, job title, department, and office location.
Add more user properties under Advanced settings → Search properties. Configure the property name and validate it before saving.
Search supports locale-specific characters. Test accented or other special characters using the spelling stored in the profile.
Exclude disabled accounts excludes disabled accounts from directory results. It is on by default.
User types selects which account types to include. Members are included by default; guests and accounts with no user type can also be selected.
Available quick filters chooses which quick-filter fields users can use. Country, department, job title, office location, and company name are enabled by default.
The selected order determines the display order of filters. Dropdowns are searchable, and cascading filters narrow later choices based on the current selections.
Advanced filters adds conditions based on person properties using operators and values. Conditions can match all or any values. Manager and group-membership fields use pickers.
The default filters require job title, first name, and last name to contain data. A person missing one of these values may be omitted even when their account is otherwise included.
Configure each condition using the supported field, operator, and value or picker, then save the filters. Test with expected people and excluded people. When results are unexpected, start with one condition and add further conditions after verifying the results.
Staff Directory uses shimmer placeholders while directory information loads. These placeholders follow the site theme and are replaced by profile content when loading completes.
Staff Directory uses caching to improve responsiveness. The Refresh people interval under Advanced settings controls how often data is refreshed from Microsoft Graph and defaults to 20 hours. Shorter intervals can increase Microsoft Graph API requests.
Upgrading to the most recent version of the app is simple.
After upgrading, review any pending API permission requests, confirm the deployed version, and test default and available views, custom properties, filtering, celebrations, sharing, and export. Consult the release notes for changes since your previous version.
For version-specific fixes and changes, see the Staff Directory release notes. If an issue persists on the current version, contact Cloudwell with the deployed app version, whether it occurs in SharePoint or Teams, the steps to reproduce it, and the displayed error message.
See the Staff Directory release notes for the history of enhancements and fixes.
| Cookie | Duration | Description |
|---|---|---|
| cookielawinfo-checkbox-analytics | 11 months | This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Analytics". |
| cookielawinfo-checkbox-functional | 11 months | The cookie is set by GDPR cookie consent to record the user consent for the cookies in the category "Functional". |
| cookielawinfo-checkbox-necessary | 11 months | This cookie is set by GDPR Cookie Consent plugin. The cookies is used to store the user consent for the cookies in the category "Necessary". |
| cookielawinfo-checkbox-others | 11 months | This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Other. |
| cookielawinfo-checkbox-performance | 11 months | This cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Performance". |
| viewed_cookie_policy | 11 months | The cookie is set by the GDPR Cookie Consent plugin and is used to store whether or not user has consented to the use of cookies. It does not store any personal data. |
PRODUCT DEMO
Choose a time to explore our Microsoft 365 apps and discuss your team’s needs.
LET’S TALK
Choose a time to discuss your goals, explore your options, and find a practical next step.