Configuration
Admin Configuration is done via the web part property pane. Edit the page, click the web part, then click the pencil icon on the left side.
TeamBook Employee Directory is configured entirely through the SharePoint property pane — no code or external tools required.
General settings
| Setting | Description | Default |
|---|---|---|
| Title | The heading shown at the top of the web part | Our People |
| Default view | Which tab is active when the page loads: Directory, OrgChart, Departments, or Locations | Directory |
| Results per page | Number of people shown per page in directory and filtered views | 25 |
| Show search bar | Toggle the search input on or off | On |
| Show filters | Toggle the Department / Location filter dropdowns | On |
Presence settings
| Setting | Description | Default |
|---|---|---|
| Show presence | Display live Teams presence indicators on person cards | On |
| Presence refresh interval | How often (in seconds) presence data is refreshed | 60 |
Presence requires the
Presence.Read.All Graph permission to be approved. If the permission is missing, this toggle has no effect.
Tabs visibility
Control which tabs are visible to end users:
| Setting | Description | Default |
|---|---|---|
| Show Directory tab | Show/hide the Employee Directory view | On |
| Show Org Chart tab | Show/hide the Organisation Chart view | On |
| Show Departments tab | Show/hide the Departments view | On |
| Show Locations tab | Show/hide the Office Locations view | On |
If you only want to expose the directory (e.g. on a simple intranet page), turn off the Org Chart, Departments, and Locations tabs.
Departments data source
| Setting | Description |
|---|---|
| Departments source | Entra ID (default) or SharePoint List |
| Departments list URL | URL of the SharePoint list to use (only shown when source is set to SharePoint List) |
When using a SharePoint list, each item should have:
- Title — the display name of the department
- EntraID_Department — the matching
departmentvalue from Entra ID (for linking users to this group) - Description (optional) — a short description shown in the departments tile
- Photo (optional) — an image column for a department banner image
See Managing Departments for the full list schema.
Locations data source
| Setting | Description |
|---|---|
| Locations source | Entra ID (default) or SharePoint List |
| Locations list URL | URL of the SharePoint list to use (only shown when source is set to SharePoint List) |
When using a SharePoint list, each item should have:
- Title — the display name of the office/location
- EntraID_Office — the matching
officeLocationvalue from Entra ID - Address (optional) — street address for display
- City (optional) — city name
- MapURL (optional) — a link to Google Maps or Bing Maps
- Photo (optional) — an image of the office
See Managing Locations for the full list schema.
Appearance / Theming
| Setting | Description | Default |
|---|---|---|
| Accent colour | Primary colour used for tabs, buttons, and active states | Tenant brand colour |
| Card layout | Grid (photo-led cards) or List (compact rows) | Grid |
| Show profile photos | Show real photos, or use initial-based avatars for all | On |
Saving your configuration
After making changes in the property pane:
- Review the live preview on the page.
- Click Apply in the property pane.
- Publish the page to make changes visible to all users.