# Pinned Items Widget

### Overview

The Pinned Items widget provides a central hub for your most important content, offering one-click access to the pages, files, and workspaces you use most. While previously accessible only via the desktop portal, pinned items can now be placed directly onto dashboards and pages, ensuring your essential shortcuts are always available on both web and mobile.

<figure><img src="/files/ZBdP03Bw0ul6ITZHXfjg" alt=""><figcaption></figcaption></figure>

The widget acts as a personalized shortcut gallery. Because content is user-specific, the widget dynamically adapts to whoever is viewing it. For example, an admin can place one widget on the Company Home page, and every employee will see their own unique set of pins.

Supported content types include:

* Departments and Groups
* Specific Pages and Files
* Workspaces and Trackers

***

### Placement Options

The widget is optimized for:

* Network Dashboards
* Company & Team Pages
* The News Feed right-hand panel

***

### Configuration Settings

When adding the widget, you can customize the following properties:

* **Custom Title**: Give the widget a specific name (e.g., "My Shortcuts" or "Quick Access").
* **Visibility**: Define which audiences can see the widget.
* **Display Limit**: Choose how many items to show at once (e.g., 3, 5, or 10 items).
* **Header Image**: Add an optional image to the top of the widget to match your page branding.

{% hint style="info" %}
Changes to the widget configuration will only appear to users once the dashboard or page has been Published.
{% endhint %}

***

### The User Experience

The widget is designed to be intuitive and consistent across all your devices.

* **Personalized View**: The widget displays your items in order of "Most Recently Pinned."
* **Cross-Platform Consistency**: Your pins stay in sync. Whatever you pin on the web portal will automatically appear in the mobile widget and the user portal dropdown.
* **Mobile Accessibility**: On mobile devices, the widget is fully touch-optimized, appearing on home dashboards and team pages for easy navigation on the go.
* **Empty State**: If you have not pinned any items yet, the widget will show a helpful prompt to guide you on how to start saving your favorite content.

***

### Frequently Asked Questions

**Is the widget content the same for everyone?**

No. While the *widget* is placed by an admin, the *content* inside is unique to each logged-in user.

**Can I pin more items than the display limit?**

Yes. You can have as many pins as you like in your profile. The widget simply displays the top $$ $X$ $$ number of items based on the "Display Limit" set by the admin.

**How do I add items to this widget?**

Simply pin any supported content (files, pages, etc.) using the standard "Pin" icon found throughout the platform. The widget will update automatically to include your newest pin.


---

# 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/widget-gallery/pinned-items-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.