Comment Pins for Jira: documentation

Comment Pins for Jira by Loomwise lets you pin important comments to the top of a Jira Cloud issue. Each pin shows the author, the date, a short excerpt and a jump link to the original comment. Jira Cloud has no built-in way to do this (JRACLOUD-74995, JRACLOUD-60438).

Free for up to 10 users, paid per user above that through Atlassian · Jira Cloud · Runs on Atlassian Forge

On this page: Pin and unpin · Who can pin · Maximum pins · JQL · Permissions and privacy · Pricing · FAQ · Support

Pin and unpin a comment

A Jira site admin installs Comment Pins for Jira from the Atlassian Marketplace and approves the permissions on Atlassian's consent screen.
Open an issue. The Pinned comments panel is on the issue. If nothing is pinned yet, it says so.
Select Pin a comment in the panel, or open the issue's actions menu and choose Pin a comment.
Pick a recent comment and select Pin. The comment appears at the top of the panel with its author, date, a short excerpt, who pinned it, and a View comment link that jumps to the original comment.
To remove a pin, select Unpin on that comment. The original comment itself is not deleted.

Up to the 50 most recent comments are shown in the picker. Only people who can already see a comment will see it in the picker or as a pin.

Who can pin

A project administrator can change this under Project settings > Comment Pins:

Anyone who can edit issues in this project (default). Project administrators can always pin as well.
Project administrators only.

The same people can unpin. If you cannot pin, the Pin and Unpin buttons are not shown.

Maximum pins per issue

Default is 5. A project administrator can set this to any number from 1 to 20 on the same project settings page. If the maximum is reached, unpin one comment before pinning another.

Search with JQL

Pins are stored as an issue property, and two search aliases are declared:

pinCount > 0 — issues that have at least one pinned comment.
pinnedComments ~ "10001" — issues where that comment id is pinned.

Jira may take a short time to index a newly written property before it appears in search.

Permissions and privacy

Every request runs as the person looking at the issue, so comments they cannot already see (for example comments restricted to a role or group) are never shown to them, as a pin or in the picker.
The pin list is stored as a Jira issue property on that issue (loomwise-comment-pins): the comment id, the account id of the person who pinned it, and the time. Project settings are stored as a Jira project property. The app does not use Forge storage and contacts no outside servers. It runs entirely on Atlassian Forge.
Scopes: read:jira-work, write:jira-work and write:project.property:jira (to save project settings).
Privacy policy: Atlassian app privacy policy · Terms: Atlassian app terms.

Pricing

Free for sites with up to 10 users. Larger sites pay per user through Atlassian; the current price is on the Marketplace listing.

FAQ

Does unpinning delete the comment? No. It only removes the pin. The comment stays in the activity feed.

What if a pinned comment is deleted, or I cannot see it? It is hidden from you. People who can still see it will still see the pin, until someone with permission unpins it.

Does this work on Jira Service Management? The panel and action appear on issues in Jira, including the agent view. The customer portal is not supported in this version.

Is there a native Cloud feature for this? Not at the time this was written. Data Center has had pinned comments (JRASERVER-60438). Cloud requests are still open.

Support

Email hello@loomwise.app with your Jira site URL and the issue key where something looks wrong. We aim to reply within 24 hours.