Web Parts
People Listing
Display people from People Search API or a curated SharePoint list with card or list layouts.
PeopleFeature Parity: 95%
Get People Listing Working in 3 Steps
15-30 minutes
Prerequisites
- Bonzai 2 package installed on your site
- For List mode: a SharePoint list with person entries
1
Add the web part
Edit your page and add "Bonzai People Listing" from the Bonzai category.
2
Choose data source
Select "People Search" for Azure AD users or "SharePoint List" for curated people.
3
Configure display options
Choose Cards or List layout, set items per page, toggle field visibility, and publish.
Two data source modes
People Listing supports two modes: People Search (pulls from Azure AD via SharePoint Search) or SharePoint List (pulls from a custom list you manage).
Data Source Modes
- People Search: Uses SharePoint People Search API to display users from Azure AD. Great for organization-wide listings with automatic profile data.
- SharePoint List: Pulls from a custom SharePoint list with a Person/User column. Ideal for curated teams, project groups, or external contacts.
When to Use This Web Part
Use this when you need to...
- Display a curated team member list
- Show specific people (leadership, project team)
- Create an "Our Team" section
- Feature new hires or key contacts
- Display external contacts not in Azure AD
Best page locations
- About Us page — leadership team
- Department pages — team members
- Project pages — project team
- Homepage — team spotlight widget
Consider alternatives when...
- • Full employee search with A-Z filter — use Employee Directory
Related web parts:
Employee Directory — searchable A-Z directorySpotlight Rollup — featured employee stories
Common Configurations
Organization Team Grid
Card layout from People Search
Best for: People page
Configuration
| title | Our Team |
| dataSource | People Search |
| displayAs | Cards |
| itemsPerPage | 12 |
| showPhoto | On |
| showJobTitle | On |
| showDepartment | On |
Leadership Team
Curated list of executives
Best for: About Us page
Configuration
| title | Leadership |
| dataSource | SharePoint List |
| listName | Leadership Team |
| displayAs | Cards |
| showPaging | Off |
Project Team List
Compact list view of team
Best for: Project page
Configuration
| title | Project Team |
| dataSource | SharePoint List |
| listName | Project Teams |
| displayAs | List |
| showTableHeaders | On |
Department Members
Cards with contact info
Best for: Department page
Configuration
| title | HR Team |
| dataSource | People Search |
| displayAs | Cards |
| showEmail | On |
| showPhone | On |
Best Practices
Use People Search for dynamic data
People Search mode automatically pulls photos, titles, and departments from Azure AD profiles.
Use List mode for curated content
List mode gives you full control over who appears and in what order.
Combine with views
In List mode, create SharePoint views to filter by department or project and select that view.
Reference
People List Schema (for List mode)
When using SharePoint List mode, create a list with a Person/User column:
- Create a SharePoint list for curated people.
- Add a Person/Group column and select it in the web part property pane.
- Optional: add extra fields for external contacts or custom metadata.
| Column | Type | Required | Description |
|---|---|---|---|
| Title | Single line of text | Yes | Entry title or name |
| Person | Person or Group | Yes | The user column (configure via Person Column property) |
| External Name (configurable) | Single line of text | No | Optional for external contacts (map via External Name field) |
| External Email (configurable) | Single line of text | No | Map to email field for external contacts |
| External Job Title (configurable) | Single line of text | No | Map to job title field |
| External Department (configurable) | Single line of text | No | Map to department field |
| External Location (configurable) | Single line of text | No | Map to location field |
| External Phone (configurable) | Single line of text | No | Map to phone field |
| External Photo URL (configurable) | Hyperlink | No | Map to photo URL field |
| (Additional) | Various | No | Custom columns for display (configure via Additional Columns property) |
Property Pane Configuration
Title Settings
| Property | Type | Description |
|---|---|---|
title | Text | Web part title |
titleUrl | Text | Optional URL to make the title clickable |
titleIconOption | Dropdown | Title icon mode: Custom or None |
titleIconName | Icon Picker | Fluent UI icon picker (default: People) |
titleIconUrl | Text | Custom icon URL (overrides icon name) |
description | Text (Multiline) | Optional description below the title |
showMoreText | Text | Text for footer link |
showMoreUrl | Text | URL for footer link |
chromeType | Dropdown | Chrome type: None, Title Only, Border Only, Title and Border |
Data Source Selection
| Property | Type | Description |
|---|---|---|
dataSource | Dropdown | People Search or SharePoint List |
People Search Settings (when dataSource = People Search)
| Property | Type | Description |
|---|---|---|
resultSource | Text | SharePoint search result source (default: Local People Results) |
searchPlaceholder | Text | Placeholder text for search box |
List Settings (when dataSource = SharePoint List)
| Property | Type | Description |
|---|---|---|
siteUrl | Text | Site URL where list is located (empty = current site) |
listName | List Picker | SharePoint list with person entries |
viewName | View Picker | View to filter people |
personColumn | Text | Internal name of the Person/User column |
additionalColumns | Text (Multiline) | Additional columns to display (format: Title:InternalName;...) |
showPromotedItems | Toggle | Show only promoted items |
Field Visibility
| Property | Type | Description |
|---|---|---|
showPhoto | Toggle | Display profile photos (default: On) |
showJobTitle | Toggle | Display job title (default: On) |
showDepartment | Toggle | Display department (default: On) |
showLocation | Toggle | Display location (default: On) |
showEmail | Toggle | Display email (default: On) |
showPhone | Toggle | Display phone (default: On) |
Display Options
| Property | Type | Description |
|---|---|---|
displayAs | Dropdown | Cards or List |
itemsPerPage | Slider (6-30) | People per page (step: 3, default: 12) |
showPaging | Toggle | Enable pagination (default: On) |
showSearch | Toggle | Enable search box (default: On) |
showTableHeaders | Toggle | Show table headers in List view (default: On) |
fixedHeight | Slider (0-800) | Fixed height in pixels (0 = auto) |
Features Checklist
- ✅ Two data source modes (People Search, SharePoint List)
- ✅ Cards and List display layouts
- ✅ Configurable field visibility
- ✅ Search functionality
- ✅ Pagination
- ✅ View-based filtering (List mode)
- ✅ Profile photos
- ✅ Contact information display