Staff Directory support

Everything needed to install CTRLAB Staff Directory, get people appearing, and configure it. If the directory is empty, start at Approve the permissions, which is almost always the answer.

Install it

A SharePoint administrator installs the app once, for the whole tenant. There is nothing to download and nothing to run on anyone’s machine.

  1. Find it in the marketplace

    CTRLAB Staff Directory, in Microsoft Marketplace or the SharePoint Store.

  2. Add it to your app catalog

    Accept when SharePoint offers to add it to the tenant app catalog.

  3. Approve the two permissions

    The step below. Until it is done, the directory will be empty.

Approve the permissions

Installation requests two Microsoft Graph permissions. Both are read-only, and a global administrator approves them once, in the Microsoft 365 admin centre under Settings → Integrated apps → API access, or in the SharePoint admin centre under Advanced → API access.

User.Read.All

Name, job title, department, office, city, country, email address, telephone numbers, manager and profile photo.

Presence.Read.All

Microsoft Teams availability, so the presence dot can be shown.

Until these are approved the directory will be empty. This is the single most common reason a new installation appears not to work, by a wide margin. If people are missing rather than absent entirely, it is a filter instead. See Some people are missing.

The app requests nothing else. It cannot read mail, files, calendars, Teams messages or SharePoint content, and it cannot write or change anything in your directory. Because the permissions are delegated, every reader queries Microsoft Graph as themselves, so the app can only ever show a person what their own account is already permitted to see. What is and is not transmitted is set out in the privacy notice.

Add it to a page

  1. Edit the page

    Go to the SharePoint page where you want the directory and choose Edit.

  2. Add a web part

    Hover above or below an existing web part and click the circled +.

  3. Pick Staff Directory

    Start typing “Staff Directory” in the search box and select it from the results.

  4. Open its settings

    With the web part selected, click the pencil icon. Everything in the settings reference below is in that pane.

  5. Republish

    The directory is live for everyone who can see the page.

You need SharePoint member permissions or higher to edit a page and change these settings.

Use it in Teams

Staff Directory also runs inside Microsoft Teams, as a tab in a team or channel, and as a personal app from the Teams app bar. Add it the same way you add any other Teams app; the settings are identical and are reached from the tab’s dropdown menu.

Department Team is a SharePoint web part only. It is built for department and hub pages and is not available as a Teams tab.

The two web parts

Staff Directory

The whole organisation, searchable, with filters for department, job title, manager, office and country, an A–Z index, card and list views, Teams presence, a details panel with the reporting line, and export to Excel, CSV or PDF. Runs in SharePoint and in Microsoft Teams.

The same directory in list view, as a sortable table with columns for name, department, office, reports to, email address and telephone number
List view, with the columns each page author chooses.

Department Team

One department, its people, and the person who leads it, worked out automatically from the reporting structure already in Microsoft Entra ID, so nobody has to change a name on a page when someone is promoted. For department and hub pages. SharePoint only.

A department page showing the Engineering team with its director presented above the roster, and a button to show all eleven people
The lead is derived from the reporting tree, and can be overridden.

Settings reference

Every control, filter, column and card field can be shown or hidden from the web part property pane. No code, and no support ticket. The groups below appear in the order the pane presents them.

The Staff Directory property pane open beside the directory, showing toggles for search and filters, the A–Z filter, the card and list switch, summary counts, Teams presence and the export options

Staff Directory

Layout

Default view
Whether the web part opens on the card grid or the list. Readers can still switch, unless the switch itself is hidden.
Card size
Small, medium or large. Larger cards carry more detail; smaller ones fit more people on the screen at once.
Compact rows in list view
Tightens the row height in the list, so more people are visible without scrolling. Off by default.
Split into pages
Pages the directory rather than showing everyone at once. Turn it off for a small organisation where one page is the whole company.
People per page
How many people each page holds, from 12 to 120 in steps of 12. Only available when the directory is split into pages.

Controls

Exports contain exactly the people currently listed, which the reader can already see, so hiding them is a tidiness choice rather than a permission boundary. PDF opens the browser print dialog, where the reader chooses Save as PDF.

Search and filters
Shows or hides the search box and the filter dropdowns together. Hide them on a page that is already narrow enough.
A–Z filter
The alphabetical index across the top, for jumping to a surname without typing. Letters with nobody behind them are dimmed.
Card / list switch
Lets readers change between the card grid and the list. Hide it to hold everyone to the default view you chose.
Summary counts
The people, departments and offices totals above the results, which also show how far a search has narrowed things.
Teams presence indicator
The availability dot on each card and row. Requires the Presence.Read.All permission to have been approved.
Open a details panel when a name is clicked
Turns the full record on or off. With it off, names are not clickable and the card actions are the only way to make contact.
Sort and file people by
Last name or first name. This governs both the sort order and which letter someone files under in the A–Z index.
Export to Excel
Offers an Excel download of the people currently listed, carrying whatever filters are applied at the time.
Export to CSV
Offers the same set as a CSV file, for loading into something else rather than reading directly.
Export to PDF
Offers a PDF of the current results. This opens the browser print dialog, where the reader chooses Save as PDF.

Filter dropdowns

A dropdown is hidden automatically when no one in the directory has a value for it, so a field nobody fills in never appears as an empty control.

Department
The department dropdown, built from the departments actually present in your directory rather than from a fixed list.
Job title
The job title dropdown. Useful where titles are consistent; less so where every person has a slightly different one.
Manager
Filters to the people who report to a given manager, read from the manager field in Entra ID.
Office location
The office dropdown, from the office location on each person’s profile. The most used filter in multi-site organisations.
Country
A broader geographic filter than office, for organisations whose sites span several countries.

List view columns

The name column is always shown.

Job title
Shows the job title column in the list view, sortable like the others.
Department
Shows the department column, which is usually the second most scanned after the name.
Office
Shows the office location column, for finding who is at which site.
Reports to
Shows each person’s manager as a column, read from Entra ID and linked through to that person.
Email
Shows the email address column as a link that opens a new message. Consider hiding it on pages that guests can reach.
Phone
Shows the telephone column, again as a link. Blank for anyone with no number on their profile.

Card fields

Department
Shows the department on each card. Name and job title are always shown.
Office location
Shows the office on each card, which small cards may not have the room for.
Reports to
Shows the manager’s name on each card, without needing the details panel.

Who is included

Accounts to show
Licensed users only, which is the recommendation, or every account. Licensed-only keeps shared mailboxes, room accounts and service accounts out of the directory.
Always exclude these people
A list of email addresses, one per line, that never appear regardless of any other setting. For the handful of accounts that pass every rule but should not be listed.

Advanced rules (optional)

Rules, as JSON
Precise inclusion rules for cases the dropdowns cannot express: excludeUsers, excludeDepartments, includeOnlyDepartments, excludeJobTitles, includeOnlyLocations, and customRules with mustHaveManager, mustHavePhone and excludeGuests. Leave it empty unless you need it.

Department Team

Department

If the department list is empty, people need a Department set on their profile in Microsoft Entra ID before they can be grouped here.

Department
Which department this web part shows. The list is read from your own directory, so it offers the departments that actually exist.
Heading
Shows or hides the heading above the roster. Hide it where the page already has one immediately above.
Heading text
Overrides the heading. Leave it empty to use the department name exactly as Entra ID holds it.
Number of people
Shows the count beside the heading. Only available while the heading itself is shown.

Department lead

Automatic picks the person whose own manager sits outside this department. Choose someone explicitly when manager information in Entra ID is incomplete.

Show a lead above the team
Presents one person above the roster rather than listing them among everyone else.
Who leads it
Leave it automatic to derive the lead from the reporting tree, or name someone explicitly where the manager data cannot be trusted.
Label above the lead
The wording above that person. “Department lead”, “Head of”, or whatever your organisation says.

Layout

Card size
Small, medium or large, matching the Staff Directory web part’s card sizes.
People shown before “Show all”
How many of the team appear before the expand button, from 0 to 48 in steps of 4. Zero shows everyone straight away.

Controls

Search box
A search within this department only. It appears for larger teams, where scanning the roster stops being quicker than typing.
Teams presence indicator
The availability dot on each card, exactly as in the Staff Directory web part.
Open a details panel when a name is clicked
Turns the full record on or off for the people in this roster.

Card fields

Name and job title are always shown.

Office location
Shows the office on each card, useful where one department spans several sites.
Reports to
Shows each person’s manager on their card, which in a single department is often the lead shown above.

Who is included

Accounts to show
Licensed users only, or every account including shared mailboxes. The same choice as the Staff Directory web part, set separately for this roster.

Trial and licensing

The app installs as a full-featured 15-day free trial. Nothing is disabled or limited during it, and a banner shows how many days remain.

When the trial ends, the directory is replaced by a short notice with a link to purchase. Nothing needs to be reinstalled. Once the licence is active, the web parts you already have start working again on their own, usually within a minute. Refresh the page.

Licences are annual and cover the entire tenant, with unlimited users and unlimited site pages. Pricing is banded by organisation size and never by feature: every band includes everything. See pricing, and the licence terms for renewal and refunds.

Order from the View pricing button inside the web part where you can. That link carries your Microsoft 365 organisation across to the order form, which is what a licence is issued against. Ordering from the website directly works too, we will just ask you for it.

Ordering is a short form rather than a checkout: tell us the band and we will confirm it, send an invoice with payment details, and activate the licence once payment clears. No card details are asked for at any point. You will hear from a person within one working day, Monday to Friday.

Upgrading

Updates are published to Microsoft Marketplace. A SharePoint administrator approves the new version in the tenant app catalog, and pages carrying the web parts pick it up on their next load. Settings are preserved across an upgrade; no page needs re-editing.

Uninstalling

Remove the web parts from any pages using them, then remove the app from the tenant app catalog. Nothing is left behind in your tenant: the app stores no lists, no site columns and no content of its own. To have your organisation’s licence record deleted from our side as well, email us and we will remove it.

Limitations

  • It shows what Entra ID holds. Where a department, job title or telephone number is blank there, it is blank here. The app does not invent or infer values.
  • Department Team is SharePoint only, and not available as a Teams tab.
  • There is no org chart. The details panel shows a reporting line and direct reports, and Department Team derives a department lead, but neither renders an organisation chart.
  • Birthdays and hire dates are not shown. The app does not read those fields.
  • A filter with no values anywhere is hidden rather than shown empty, which is why a dropdown you expected may be absent.

Common questions

The directory is empty. What did I miss?

Almost always the Microsoft Graph permissions have not been approved yet. A global administrator approves User.Read.All and Presence.Read.All once, in the Microsoft 365 admin centre under Settings → Integrated apps → API access, or in the SharePoint admin centre under Advanced → API access. Until that happens the web part has nothing to read. If they have been approved, allow a few minutes and reload the page.

Some people are missing.

Check the Who is included settings. By default only licensed users appear, which deliberately excludes shared mailboxes, room accounts and service accounts. Then check whether an exclusion list or an advanced rule is filtering them out.

Does our staff data leave our tenant?

No. Every reader’s browser talks to Microsoft Graph directly, using that reader’s own Microsoft 365 account, and the details are displayed and discarded in the browser. Directory data is never sent to CTRLAB. The privacy notice sets out exactly what is and is not transmitted.

Photos are not showing.

The app uses the profile photos already in Microsoft 365. Where someone has not set one, their initials are shown instead.

Presence is not showing.

Confirm that Presence.Read.All was approved, and that the Teams presence indicator toggle is on in the web part settings.

Departments or job titles are blank.

The app displays what is in Microsoft Entra ID. If a field is empty there, it is empty here. A filter with no values anywhere is hidden automatically rather than shown empty, which is why a dropdown you expected may be absent.

What happens when the trial ends?

The trial runs for 15 days with nothing disabled or limited. When it lapses, the web parts show a short notice with a link to purchase instead of the directory. Nothing needs to be reinstalled: once the licence is active the web parts you already have start working again on their own, usually within a minute.

It still says the trial has ended after I paid.

Refresh the page once. If it persists beyond a few minutes, email [email protected] with your tenant name and we will look straight away.

Can we use it in Microsoft Teams?

Staff Directory runs as a Teams tab and as a personal app, as well as a SharePoint web part. Department Team is a SharePoint web part only, because it is built for department and hub pages.

Contact support

Email [email protected]. Include your tenant name, and a screenshot if something is not rendering as you expect.

We answer within one working day, Monday to Friday, 09:00–17:00 CET.