Managing Departments

Departments appear as filter chips in the directory. They are stored as a SharePoint list (default name: TeambookDepartments).

Open the admin panel

Click the Admin Dashboard button in the header (Site Owners only), then the Departments tab.

Adding a department

1. Click + Add department.
2. Enter a name (required), description, and icon (pick from a visual icon library).
3. Choose a colour.
4. Save.

Editing or deleting

• Click the pencil icon on any row to edit.
• Click the trash icon to delete. Employees keep their existing department name but the filter chip disappears.

One-click Azure AD import

Click Import from Azure AD. The web part scans every user’s Entra ID department field and creates a department for each distinct value it finds.

Duplicate detection is case-insensitive; existing departments are not overwritten.

Why use this list?

The list lets you:

• Add descriptions and branded icons/colours for each department
• Show departments that don’t yet have employees assigned
• Keep the sidebar clean if Entra ID data is messy

If you skip the admin setup entirely, the directory still works — it will just show whatever raw values appear in Entra ID’s department field.