Managing Locations

Admin  This guide covers the in-app Manage Locations panel — accessible from the sidebar in the directory web part. SharePoint or site-owner permission is required to open it.

Every office, hub, or remote-team region is a row in the TeambookLocations SharePoint list inside your site collection. The list is auto-provisioned the first time the directory loads. Manage it from the Manage Locations sidebar item rather than editing the SharePoint list directly.

Opening Manage Locations

  1. Open any page hosting the directory web part.
  2. In the sidebar, click Manage Locations (visible only to SharePoint site owners / admins).
  3. The panel opens with the current list of offices.

One-click import from Microsoft Entra ID

  1. Click Import from Microsoft 365.
  2. The panel scans every employee’s officeLocation field in Microsoft Entra ID and lists every distinct value.
  3. Tick the offices you want to bring in.
  4. Click Import.
  5. Each ticked value becomes a new row in TeambookLocations with a default icon and accent colour. Address, photo, timezone, and HQ flag are blank — you fill those in next.

Importing is idempotent. Existing rows are never overwritten.

Editing a location

Click any row to open the editor. Fields:

FieldDescription
TitleThe display name shown on the Locations grid and detail page.
Microsoft Entra ID office valueThe exact value in Entra ID that should match users to this location. Case-insensitive.
CountryCountry name, shown as a subtitle on the location tile.
AddressStreet address — shown on the detail page; deep-links to Google Maps.
Postcode / ZIPOptional.
PhoneOffice phone, with tel: click-to-call on the detail page.
Office manager emailOptional. Their avatar appears as “Office manager” on the detail page.
IANA timezonee.g. Europe/London, America/New_York, Asia/Tokyo. Required for the optional “show local time per person” feature.
Banner photo URLA photo of the office building or area — shown as the detail-page hero.
Thumbnail URLOptional smaller image for the grid tile.
Accent colourA hex colour for the detail-page hero gradient and the location pill.
HeadquartersTick if this is your HQ — gets a badge and sorts first on the grid.
HiddenTick to keep the row but hide from the user-facing grid.

Click Save. Changes appear in the directory on the next page load.

Adding a location manually

  1. Click + Add location.
  2. Fill in at minimum the Title and the Microsoft Entra ID office value.
  3. Add address, timezone, and photo if you have them — these substantially improve the detail-page experience.
  4. Click Save.

Setting up local time per person

If you want the optional Show local time per person feature (enabled in Settings → Features), every office that should show a clock needs a valid IANA timezone.

Find your timezone identifier here: List of tz database time zones. Examples:

  • Europe/London
  • Europe/Berlin
  • America/New_York
  • America/Los_Angeles
  • Asia/Tokyo
  • Australia/Sydney

If an office is missing a timezone, colleagues based there simply won’t show a clock — no error, just hidden.

Headquarters and sorting

Mark exactly one location as Headquarters if you want a prominent HQ badge on the grid and detail page. HQ sorts first, followed by all other locations alphabetically. You can flip the HQ flag between offices any time.

Direct SharePoint-list access (advanced)

The underlying list lives at https://<tenant>.sharepoint.com/sites/<your-site>/Lists/TeambookLocations. You can edit it directly, but the in-app panel is recommended because:

  • It validates the IANA timezone against the JS Intl engine before saving.
  • It previews the office photo at the size used in the detail-page hero.
  • It catches duplicates (same Microsoft Entra ID office value twice).

Column names if you do open the list: Title, EntraOfficeValue, Country, Address, Postcode, Phone, OfficeManagerEmail, TimeZone, PhotoUrl, ThumbnailUrl, AccentColor, IsHeadquarters, Hidden.