Every Jira issue tells a story. The summary says what needs to be done. The status says where it stands. The assignee says who owns it. But the real story — the decisions that shaped the work — lives somewhere else entirely.
It lives in the comments.
The Comment Problem
Think about your last sprint. How many decisions were made in Jira comments that never made it into a structured field? A stakeholder approved a design direction. A developer flagged a blocker. A product manager clarified scope. The tech lead said "let's skip this for v1 and revisit later."
All of that context is captured — technically. It's sitting in comment threads, attached to specific issues, timestamped and attributed. But try finding it three months later. Or next quarter, when someone asks "why did we build it that way?"
The honest answer is usually: nobody remembers, and nobody can find the comment where it was decided.
Why Standard JQL Can't Help
Jira's built-in search is surprisingly limited when it comes to comments. You can filter by status, assignee, priority, labels, fix versions — all the structured fields. But you can't search by:
- Who commented — "show me every issue where the security team weighed in"
- When a comment was added — "what discussions happened during the last sprint?"
- What was said — "find issues where someone mentioned 'deployment risk'"
This means the richest source of project context — the actual human conversation around the work — is effectively invisible to JQL. You can see that an issue has comments, but you can't search inside them.
Turning Comments into a Searchable Layer
Argon's commented JQL function changes this. It lets you query issues based on their comment activity — filtering by author, date range, and content — directly from Jira's search bar.
The syntax follows the same pattern as Argon's other activity functions:
issue in commented("subquery", "author", "dateFrom", "dateTo", "bodyContains")The first argument is a JQL subquery that scopes which issues to search. The remaining arguments filter by who wrote the comment, when it was written, and what it contains. Any argument can be left empty to skip that filter.
Practical Examples
Find issues where a specific person commented:
issue in commented("project = MARS", "john.doe")This is useful when someone is leaving the team and you need to find every issue where they provided context, or when you need to audit what a specific stakeholder has reviewed.
Find issues with comments from a specific time range:
issue in commented("project = MARS AND status = Done", "", "2026/01/01", "2026/03/31")Perfect for quarterly reviews. This finds every completed issue that had discussion during Q1 — helping you build a richer picture of what happened beyond just "it got done."
Find issues where a keyword appeared in the discussion:
issue in commented("project = MARS", "", "", "", "blocker")When someone mentions "blocker" in a comment, it usually means something important happened. This query surfaces those moments without requiring anyone to have updated a structured field.
Combine all filters for precision:
issue in commented("project = MARS AND fixVersion = 'v2.5'", "jane.smith", "2026/03/01", "2026/03/31", "approved")This finds issues in the v2.5 release where Jane approved something in March. That's an audit trail that would be nearly impossible to reconstruct manually.
Real-World Use Cases
Once you start thinking of comments as searchable data, new workflows open up:
Onboarding. When a new team member joins, they can search for issues where specific architects or tech leads commented — getting a curated reading list of decisions and context, filtered by the people who shaped the project.
Retrospectives. Instead of relying on memory, search for issues where "risk," "concern," or "alternative" appeared in comments during the sprint. You'll find discussions that deserve a second look.
Compliance and auditing. For teams in regulated industries, being able to prove that a specific person reviewed and approved a change — with a timestamp and their exact words — is not a nice-to-have. It's a requirement.
Knowledge recovery. When someone asks "why did we do it this way?", the answer is almost always buried in a comment thread. Now you can find it with a query instead of scrolling through dozens of issues hoping to stumble on it.
Comments Tell the Real Story
On social media, the real discussion always happens in the comments. The same is true in Jira. The structured fields tell you what happened. The comments tell you why.
The problem was never that the information wasn't captured. It was that it wasn't searchable. Argon's commented function turns Jira comments from a passive activity log into an active, queryable collaboration layer — making decisions, approvals, and context as easy to find as any other issue field.
Because in project management, just like everywhere else, the comments tell the real story. You just need a way to search them.
Try Argon for Free
Install Argon from the Atlassian Marketplace and start using advanced JQL functions in your Jira Cloud instance today.
Get Argon on Marketplace