People Widget¶
The People Widget displays user profiles from your Nextcloud instance. It's perfect for team pages, organization directories, department overviews, or any page where you want to showcase people.
Features¶
- Multiple layouts: Card, List, or Grid view
- Unified display options: All display options work consistently across all layouts
- Selection modes: Manual selection or filter-based
- Group filtering: Show users from specific groups
- Field filtering: Filter by any user profile field, including date-based filters
- Customizable display: Choose which profile fields to show
- Birthdate support: Display birthdates with a cake icon
- Social links: Twitter/X, Fediverse, and Bluesky profiles
- Sorting options: Sort by name or email
- Pagination: "Show more" button when there are more people than the configured limit
- Nextcloud integration: Click avatars to see profiles, email, and availability
- LDAP/OIDC support: Custom fields from LDAP or OIDC are automatically detected
Layouts¶
Card Layout¶
Displays users in detailed cards with avatar, name, title, contact info, and optional biography. Best for showcasing individual team members with rich information.
List Layout¶
Compact horizontal layout showing avatar, name, and key details in a row. Ideal for longer lists where space efficiency matters.
Grid Layout¶
Grid layout with avatars and key details. All display options (contact info, social links, custom fields, etc.) are supported in every layout, including Grid. Perfect for quick visual overviews of teams or departments.
Configuration¶
To add a People Widget to your page:
- Click + Add Widget in edit mode
- Select People from the widget picker
- Configure the widget settings
Settings¶
| Setting | Description |
|---|---|
| Widget title | Optional title displayed above the widget |
| Background color | None, Light, or Primary color background |
| Selection mode | Manual selection or Filter by attributes |
| Layout | Card, List, or Grid |
| Columns | For Card/Grid layouts: 2, 3, or 4 columns |
| Maximum people | Limit the number of displayed users (1-50) |
| Sort by | Name or Email |
| Sort order | Ascending or Descending |
Selection Modes¶
Manual Selection¶
Select specific users to display:
- Choose "Manual selection" mode
- Search for users by name or email
- Click to add users to the selection
- Drag to reorder (order is preserved when sorting is disabled)
Filter by Attributes¶
Automatically show users matching certain criteria:
- Choose "Filter by attributes" mode
- Click + Add filter
- Select a field (Group, Name, Email, Organisation, Role, etc.)
- Choose an operator and value
- Add more filters as needed
Available Filter Fields¶
Fields are organized in logical order matching the Display Options:
| Category | Fields |
|---|---|
| Group | Nextcloud group membership |
| Basic Information | Name, Pronouns, Role, Headline, Organisation |
| Contact | Email, Phone, Address, Website |
| Extended | Biography, Birthdate, Twitter/X, Fediverse, Bluesky |
| Custom | Additional LDAP/OIDC fields |
Filter Operators¶
| Operator | Description | Available for |
|---|---|---|
| equals | Exact match | All fields |
| contains | Partial match | Text fields |
| does not contain | Excludes partial match | Text fields |
| is one of | Match any of multiple values | Group field |
| is not empty | Field has any value | All fields |
| is empty | Field has no value | All fields |
| is today | Date matches today's date (month + day) | Date fields (e.g., Birthdate) |
| within next days | Date falls within the next N days | Date fields (e.g., Birthdate) |
Multiple Filters¶
When using multiple filters, choose how they combine:
- Match all: All filters must match (AND logic)
- Match any: At least one filter must match (OR logic)
Example: Show Marketing Team¶
- Add filter: Group → is one of → select "Marketing"
- Result: Shows all users in the Marketing group
Example: Show Managers¶
- Add filter: Role → contains → "Manager"
- Result: Shows users with "Manager" in their role field
Example: Exclude Interns¶
- Add filter: Role → does not contain → "Intern"
- Result: Shows users without "Intern" in their role
Example: Show Today's Birthdays¶
- Add filter: Birthdate → is today
- Result: Shows users whose birthday is today
Example: Show Upcoming Birthdays¶
- Add filter: Birthdate → within next days → "7"
- Result: Shows users with birthdays in the next 7 days
Note: The "is today" and "within next days" operators compare month and day only (ignoring year), which is ideal for recurring events like birthdays. Year-end wrapping is handled automatically (e.g., a filter set on December 30 with "within next 7 days" will correctly include January birthdays).
Display Options¶
Control which information is shown for each user. All display options are available in every layout (Card, List, and Grid).
Basic Information¶
| Field | Description | Default |
|---|---|---|
| Avatar | User profile picture | On |
| Name | Display name | On |
| Pronouns | User's pronouns (if set) | Off |
| Role | Official job title | On |
| Headline | Personal tagline | Off |
| Department | Department or team | On |
Contact¶
| Field | Description | Default |
|---|---|---|
| Email address (clickable) | On | |
| Phone | Phone number (clickable) | Off |
| Address | Physical address | Off |
| Website | Personal website | Off |
Extended¶
| Field | Description | Default |
|---|---|---|
| Biography | User bio | Off |
| Birthdate | Birthday with cake icon | Off |
| Social links | Twitter/X, Fediverse, and Bluesky links | Off |
| Custom fields | Additional LDAP/OIDC fields | Off |
Birthdate Display¶
When the Birthdate field is enabled, each user's birthday is displayed with a cake icon. The date is formatted according to the user's locale. This pairs well with the date filter operators to create birthday widgets (see Show Today's Birthdays).
Custom Fields (LDAP/OIDC)¶
When your Nextcloud is connected to LDAP, Active Directory, or OIDC, additional user profile fields may be available. The People Widget automatically detects these fields and makes them available for display.
Common custom fields include:
- Employee ID
- Cost Center
- Office Location
- Employee Type
- Manager
Enable "Custom fields (LDAP/OIDC)" in Display Options to show these fields on user cards. The widget automatically formats field names for readability (e.g., employee_id becomes "Employee Id").
Note: Birthdate and Bluesky are now first-class fields with dedicated display options and don't require the custom fields toggle.
Pagination¶
When there are more users matching your filters than the configured "Maximum people to show" limit, the widget displays a pagination footer:
- Shows the count: "Showing 12 of 47 people"
- Show more button to load additional users
- Continues until all matching users are displayed
This allows you to set a reasonable initial limit while still providing access to the full list.
Avatar Popup Menu¶
Clicking on a user's avatar opens Nextcloud's standard contact menu, providing:
- View profile: Opens the user's Nextcloud profile page
- Email: Send an email to the user
- Show availability: View the user's calendar availability (requires Calendar app)
- User status: See current status and custom message
This is standard Nextcloud functionality and works the same as avatar clicks elsewhere in Nextcloud.
User Profile Fields¶
The People Widget displays data from Nextcloud user profiles. The available fields depend on your Nextcloud configuration:
Standard Fields¶
These fields are available in all Nextcloud installations:
- Display name
- Phone
- Address
- Website
- Twitter/X handle
- Fediverse handle
- Bluesky handle
- Organisation
- Role (job title)
- Headline (personal tagline)
- Biography
- Pronouns
- Birthdate
LDAP/Active Directory Fields¶
If your Nextcloud is connected to LDAP or Active Directory, additional fields may be available depending on your LDAP configuration. Common examples:
- Employee ID
- Department
- Manager
- Office location
- Cost center
OIDC Fields¶
If using OpenID Connect for authentication, additional profile claims may be mapped to user fields.
Group-Based Filtering¶
The most common use case is filtering by group membership:
Single Group¶
Show all users from one group:
- Add filter: Group → equals → select group
Multiple Groups¶
Show users from any of several groups:
- Add filter: Group → is one of → select multiple groups
Combined with Other Filters¶
Show users from a group with additional criteria:
- Add filter: Group → equals → "Engineering"
- Add filter: Role → contains → "Lead"
- Set to Match all
- Result: Shows Engineering Leads only
Background Colors¶
The People Widget supports three background color options:
| Option | Description |
|---|---|
| None | Transparent background, blends with page |
| Light | Light gray background for subtle separation |
| Primary | Dark blue background (uses Nextcloud's primary color) |
When using a dark background (Primary), text colors automatically adjust for proper contrast.
Tips¶
- Performance: Limit the number of users for better page load times, especially with many profile fields enabled
- Privacy: Consider which fields to display publicly. Phone numbers and addresses are disabled by default
- Groups: Create Nextcloud groups specifically for widget display (e.g., "Leadership Team", "Support Staff")
- Profile completeness: Encourage users to complete their Nextcloud profiles for richer People Widgets
- Layouts: Use Grid for large teams, Cards for small featured teams, List for directories
- Pagination: Set a reasonable limit (12-20) and let users load more if needed
Requirements¶
- IntraVox 0.9.14 or higher
- Users must have Nextcloud accounts
- Group filtering requires users to be members of Nextcloud groups
- Calendar app required for "Show availability" in avatar popup