Managing Locations
Admin This guide is for SharePoint administrators who want to enrich office location data.
By default, TeamBook Employee Directory reads office locations directly from the Office (officeLocation) field in Microsoft Entra ID. This works out of the box without any list setup.
For a richer experience — with office addresses, photos, map links, and custom display names — you can create a Locations SharePoint list and connect it to the web part.
Creating the Locations list
- Go to the SharePoint site where the web part is installed.
- Click the Settings gear → Add an app → Custom List.
- Name it
TB_Locations(or any name you prefer). - Add the following columns:
Required columns
| Column name | Type | Description |
|---|---|---|
| Title | Single line of text | The display name of the office (e.g. “London HQ”) |
| EntraID_Office | Single line of text | The exact value from the officeLocation field in Entra ID (e.g. “London”) — used to match users to this location |
Optional columns
| Column name | Type | Description |
|---|---|---|
| Address | Multiple lines of text | Street address of the office |
| City | Single line of text | City name (shown as a subtitle on the location tile) |
| Country | Single line of text | Country name |
| MapURL | Hyperlink | A link to Google Maps or Bing Maps for this address |
| Photo | Image | A photo of the office building or location |
| FloorPlan | Hyperlink | Link to a floor plan document or page |
| SortOrder | Number | Controls the display order of location tiles (lower numbers first) |
| Hidden | Yes/No | Set to Yes to exclude this location from the people hub |
Populating the list
Add one item per office location. The EntraID_Office value must exactly match what is stored in Entra ID — it is case-sensitive.
Example:
| Title | EntraID_Office | City | Address |
|---|---|---|---|
| London HQ | London | London | 1 Example Street, EC1A 1BB |
| Manchester Office | Manchester | Manchester | 45 Deansgate, M3 2EN |
| Remote | Remote | — | — |
Linking the list to the web part
- Edit the SharePoint page containing the web part.
- Open the property pane (click the web part, then the pencil icon).
- Under Locations data source, change the dropdown from
Entra IDtoSharePoint List. - In the Locations list URL field, enter the URL of your list.
- Click Apply and publish the page.
Tips
- Keep EntraID_Office values in sync with what is actually in Entra ID. If an office is renamed in Entra ID, update both the Entra ID user records and this list.
- Adding a Photo column significantly improves the visual appeal of the locations view — even a single representative office photo makes a big difference.
- Use the MapURL column to add a direct link to the office address in Google Maps so employees can get directions in one click.
- Add a “Remote” entry with
EntraID_Office = Remoteif your organisation uses that value for home-workers.
Note: If a user's
officeLocation in Entra ID does not match any EntraID_Office value in the list, they will still appear in the directory and org chart — they simply won't be grouped under a locations tile.