Skip to main content

commented

Overview​

The commented function allows you to search for issues that have comments matching specific criteria, such as content, author, or time period.

Syntax​

issue in commented("subquery", "author", "start_date", "end_date", "content")

Parameters​

  • subquery (required): A valid JQL query that defines the set of issues to evaluate
  • author (optional): The display name of the comment author (partial match, case-insensitive)
  • start_date (optional): The start date in format "yyyy/MM/dd HH:mm" or "yyyy/MM/dd", or a relative expression like -2w (see Relative date ranges)
  • end_date (optional): The end date in the same format as start_date
  • content (optional): Text to search for in comment body (partial match, case-insensitive)

Supported Operators​

  • in - issues matching the criteria
  • not in - issues not matching the criteria

Examples​

Finding issues with comments in a date range​

issue in commented("project = SER", "", "2023/01/01", "2023/05/01")

Finding issues with comments by a specific user​

issue in commented("project = SER", "John Smith", "2023/01/01", "2023/12/31")

Finding issues with comments containing specific text​

issue in commented("project = SER", "", "2023/01/01", "", "urgent")

Finding issues without comments in a date range​

issue not in commented("project = SER", "", "2023/01/01")

Finding issues with comments by user containing specific text​

issue in commented("project = SER", "John", "", "", "approved")

Relative date ranges (self-updating)​

start_date and end_date also accept a relative expression — a leading - followed by a duration (w/d/h/m/s) — meaning "now minus that duration". Argon re-resolves the window every time the query runs (refreshed hourly), so the board stays current on its own.

-- Issues commented on in the last 3 days (what's been discussed recently)
issue in commented("project = SER", "", "-3d")

-- Comments mentioning "blocker" in the last 2 weeks
issue in commented("project = SER", "", "-2w", "", "blocker")

-- Issues NOT commented on in the last 4 weeks (stale, may need a nudge)
issue not in commented("project = SER", "", "-4w")

See Relative dates for the full format reference.

Performance Considerations​

  • The function analyzes all comments from issues matching the JQL subquery
  • Large numbers of comments may increase processing time
  • Use specific subqueries and date ranges to improve performance

Error Handling​

The function will return an error if:

  • Invalid date formats (must be "yyyy/MM/dd HH:mm" or "yyyy/MM/dd")
  • Invalid JQL queries
  • changedBy - Search for issues where fields were updated
  • transitionedBy - Search for issues transitioned to a specific status