> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.pivotal.app/llms.txt.
> For full documentation content, see https://docs.pivotal.app/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.pivotal.app/_mcp/server.

# Pinned items

A pin holds a task or a comment at the top of its parent list so anyone opening the onboarding sees it before anything else. Pins are workspace-wide. Everyone sees the same set.

## Pinned vs Favorite

These two surface similar UI (a star, a pin icon) but solve different problems. Pick the right one.

|                   | Pinned                                                    | Favorite                         |
| ----------------- | --------------------------------------------------------- | -------------------------------- |
| Who sees it       | The whole workspace                                       | You only                         |
| Scope             | One parent list (one onboarding, one customer's comments) | Your sidebar                     |
| What you can mark | Tasks, comments                                           | Customers, onboardings           |
| Limit             | 3 per parent                                              | 12 per user                      |
| Sort effect       | Pinned items rise to the top of the list                  | None; sidebar position is manual |
| Visual cue        | 📌 next to the title                                      | Filled star icon                 |

Rule of thumb: pin when the team needs to see something. Favorite when *you* need fast access.

## Pin a task

Open the onboarding, hover the task row, click **⋯ > Pin to top**. The task gets a 📌 marker and jumps above all unpinned tasks in that onboarding's task list. The pin survives task completion (a pinned, completed task stays at the top until you unpin or archive it).

## Pin a comment

Open the customer or onboarding, scroll to the comment, click the **⋯ > Pin comment**. Pinned comments render in a "Pinned" strip at the top of the comments section, separate from the normal chronological thread.

## The 3-pin limit

Each onboarding allows up to 3 pinned tasks. Each customer allows up to 3 pinned comments. The cap exists to keep the "look at this" signal meaningful. If you try to add a 4th pin, Pivotal prompts you to unpin one first.

Workspaces with more than \~50 active onboardings should treat pins as a 1-week tool: pin the blocker, resolve it, unpin. Avoid pinning long-running reminders. They lose signal over time and people scroll past them.

## Unpin

Hover the pinned row and click the 📌 icon, or open **⋯ > Unpin**. Unpinning a task returns it to its natural sort position (usually by `due_date`). Unpinning a comment returns it to its chronological slot in the thread.

## Who can pin

Any teammate with edit access to the parent record. Read-only roles see the pin icons but cannot toggle them. The audit log records each pin and unpin with actor and timestamp, viewable from [Audit log](/product/onboardings/audit-log).

## Related

* [Favorites](/product/workbench/favorites)
* [Comments and attachments](/product/onboardings/comments-and-attachments)
* [Task completion](/product/onboardings/task-completion)

Email **[help@pivotal.app](mailto:help@pivotal.app)** with a screenshot of where you got stuck and the customer or onboarding id from the URL.