The Adaptavist Group LogoDocumentation

Keywords

Warning: EAP users

This section is for users signed up for this EAP. Sign up for this round is closed, but if you are interested in signing up for future EAPs, please contact support.

Breakdown of each individual Keyword

Key

<jql>A JQL parameter is required
<jql?>A JQL parameter is optional

The following table explains how keyword syntax was previously used in Connect, and how it should be used in Forge now:

Keyword namePrevious Connect syntaxNew Forge Syntax
attachmentTypeattachmentType <comparison operator> <regex>

issue in attachmentType(<comparison operator ("in", "not in", "=" or "!=")>, <fileTypes (comma separated in a string)>, <jql?>)

Example valid uses:

issue in attachmentType("=", "pdf")

issue in attachmentType("=", "pdf", "project = TEST")

issue in attachmentType("!=", "pdf,doc")

issue in attachmentType("!=", "pdf,doc", "project = TEST")

commentedBycommentedBy <comparison operator> <accountId>

issue in commentedBy(<comparison operator ("in", "not in", "=" or "!=")>, <accountId or accountIds (comma separated in a string)>, <jql?>)

!!currentUser() will not work if used in place of <accountId>

Example valid uses:

issue in commentedBy("=", "accountId")

issue in commentedBy("=", "accountId,accountId2", "project = TEST")

issue in commentedBy("!=", "accountId,accountId2")

issue in commentedBy("!=", "accountId", "project = TEST")

commentedOncommentedOn <comparison operator> <date>

issue in commentedOn(<comparison operator>, <date or dates (comma separated in a string)>, <jql?>)

if operator is '>', '<', '>=' or '<=' it cannot be used with multiple dates

Example valid uses:

issue in commentedOn("=", "2026-04-03")

issue in commentedOn(">", "2026-04-03")

issue in commentedOn("<=", "2026-04-03")

issue in commentedOn("in", "2026-04-03,2025-03-02")

fileAttachedByfileAttachedBy <comparison operator> <accountId>

issue in fileAttachedBy(<comparison operator should be one of '=', '!=', 'in', 'not in' >, <accountId or accountIds (comma separated in a string)>, <jql?>)

!!currentUser() will not work if used in place of <accountId>

Example valid uses:

issue in fileAttachedBy("=", "accountId")

issue in fileAttachedBy("in", "accountId,accountId2", "project = TEST")

issue in fileAttachedBy("!=", "accountId,accountId2")

issue in fileAttachedBy("not in", "accountId", "project = TEST")

firstAttachmentDatefirstAttachmentDate <comparison operator> <date>

issue in firstAttachmentDate(<comparison operator>, <date or dates (comma separated in a string)>, <jql?>)

Example valid uses:

issue in firstAttachmentDate("!=", "2026-04-03")

issue in firstAttachmentDate(">", "2026-04-03")

issue in firstAttachmentDate("<=", "2026-04-03")

issue in firstAttachmentDate("in", "2026-04-03,2025-03-02")

firstCommentedDatefirstCommentedDate <comparison operator> <date>

issue in firstCommentedDate(<comparison operator>, <date or dates (comma separated in a string)>, <jql?>)

Example valid uses:

issue in firstCommentedDate("!=", "2026-04-03")

issue in firstCommentedDate(">", "2026-04-03")

issue in firstCommentedDate("<=", "2026-04-03")

issue in firstCommentedDate("in", "2026-04-03,2025-03-02")

lastAttachmentDatelastAttachmentDate <comparison operator> <date>

issue in lastAttachmentDate(<comparison operator>, <date or dates (comma separated in a string)>, <jql?>)

Example valid uses:

issue in lastAttachmentDate("!=", "2026-04-03")

issue in lastAttachmentDate(">", "2026-04-03")

issue in lastAttachmentDate("<=", "2026-04-03")

issue in lastAttachmentDate("in", "2026-04-03,2025-03-02")

lastCommentBylastCommentBy <comparison operator> <accountId>

issue in lastCommentBy(<comparison operator should be one of '=', '!=', 'in', 'not in' >, <accountId or accountIds (comma separated in a string)>, <jql?>)

!!currentUser() will not work if used in place of <accountId>

Example valid uses:

issue in lastCommentBy("=", "accountId")

issue in lastCommentBy("in", "accountId,accountId2", "project = TEST")

issue in lastCommentBy("!=", "accountId,accountId2")

issue in lastCommentBy("not in", "accountId", "project = TEST")

lastCommentedDatelastCommentedDate <comparison operator> <date>

issue in lastCommentedDate(<comparison operator>, <date or dates (comma separated in a string)>, <jql?>)

Example valid uses:

issue in lastCommentedDate("!=", "2026-04-03")

issue in lastCommentedDate(">", "2026-04-03")

issue in lastCommentedDate("<=", "2026-04-03")

issue in lastCommentedDate("in", "2026-04-03,2025-03-02")

numberOfAttachmentsnumberOfAttachments <comparison operator> <number>

issue in numberOfAttachments(<comparison operator>, <number or numbers (comma separated in a string)>, <jql?>)

Can only use multiple numbers with =,!= in, not in comparison operators

Example valid uses:

issue in numberOfAttachments("!=", "1,2,3")

issue in numberOfAttachments(">", "5")

issue in numberOfAttachments("<=", "7")

issue in numberOfAttachments("in", "3,12")

numberOfCommentsnumberOfComments <comparison operator> <number>

issue in numberOfComments(<comparison operator>, <number or numbers (comma separated in a string)>, <jql?>)

Can only use multiple numbers with =,!= in, not in comparison operators

Example valid uses:

issue in numberOfComments("!=", "1,2,3")

issue in numberOfComments(">", "5")

issue in numberOfComments("<=", "7")

issue in numberOfComments("in", "3,12")

numberOfLinksnumberOfLinks <comparison operator> <number>

issue in numberOfLinks(<comparison operator>, <number or numbers (comma separated in a string)> <jql?>)

Can only use multiple numbers with =,!= in, not in comparison operators

Example valid uses:

issue in numberOfLinks("!=", "1,2,3")

issue in numberOfLinks(">", "5")

issue in numberOfLinks("<=", "7")

issue in numberOfLinks("in", "3,12")

numberOfSubtasksnumberOfSubtasks <comparison operator> <number>

issue in numberOfSubtasks(<comparison operator>, <number or numbers (comma separated in a string)>, <jql?>)

Can only use multiple numbers with =,!= in, not in comparison operators

Example valid uses:

issue in numberOfSubtasks("!=", "1,2,3")

issue in numberOfSubtasks(">", "5")

issue in numberOfSubtasks("<=", "7")

issue in numberOfSubtasks("in", "3,12")

Search documentation

Start typing to search the docs.