# People Widget

### Overview

The **People** widget in MangoApps is a versatile tool that highlights users based on specific criteria such as recent joiners, award recipients, experts, and more. This widget can be customized to display user-related updates that foster engagement and recognition within your organization. 

<figure><img src="/files/F4fkLTk1rZN2pG1XfvZS" alt="" width="563"><figcaption></figcaption></figure>

This widget can be added to the home module, pages, and newsfeed from the widget's gallery.

***

### People Category Filter

To get started configuring the widget, you will first need to filter the type of people you want to highlight. Open the widget's 3-dot menu and select **Set Properties** to access the configuration window.

<figure><img src="/files/ayFbsmXjAgEQOAXyjngb" alt="" width="563"><figcaption></figcaption></figure>

In the **Show** dropdown, choose from the following categories:

* **Recent Joinees**: Highlights employees who recently joined the company.
* **Recent Awardees**: Displays users who have recently received an award.
* **Experts**: Lists users who are top contributors in the Questions module.
* **Work Anniversaries**: Shows users with upcoming work anniversaries.
* **Domain Admins**: Lists the domain administrators.
* **Members of a Team**: Highlights users from a selected team.
* **Specific People**: Allows you to select specific individuals manually.

This selection determines the focus of the widget and who will be displayed.

***

### Setting the Audience - Work Anniversaries Only

When **Work Anniversaries** is selected, you can further filter which users are displayed based on the following options:

* **Everyone**: Shows upcoming work anniversaries for all users across the entire domain.
* **Users I'm Following**: Shows upcoming work anniversaries only for users the logged-in user is following.
* **Users with Matching Profile Field**: Shows upcoming work anniversaries for users whose selected profile field matches that of the logged-in user.

***

### Customizing the Appearance

The appearance section allows users to customize how the information appears within the widget.

Users can choose their preferred **View** layout:

* Grid layout with profile images.
* List layout (selected in the example).

And select the **Picture Size** from options such as:

* Normal
* Large

These options help users control both the format and the visual size of user avatars shown in the widget.

***

### Setting the Display Range - Work Anniversaries/Recent Awardees

When displaying **Work Anniversaries**, you can customize how far in advance these are shown.

Use the **Display Range** section to show all anniversaries happening in the next specified number of days (e.g., next 7 days).

Similarly, when displaying **Recent Awardees**, you can use this section to show all recent awardees in the last number of days.

***

Click **Save** to apply the changes. The People widget will now display according to your chosen configuration, enriching your intranet with timely and personalized content.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.mangoapps.com/user-guide/people-directory-and-profiles/people-widget.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.