Skip to main content

Sprint Functions

Overview​

The sprint functions allow you to search for issues based on their sprint assignment relative to a specific board. These functions resolve a board name to the appropriate sprint and return matching issues.

Three functions are available:

  • currentSprint — issues in the board's active sprint
  • previousSprint — issues from the board's most recently closed sprint
  • nextSprint — issues in the board's nearest future sprint

Syntax​

issue in currentSprint("boardName")
issue in previousSprint("boardName")
issue in nextSprint("boardName")

Parameters​

  • boardName (required): The exact name of the Jira board (Scrum or Kanban) to look up sprints for

Supported Operators​

  • in — issues that belong to the resolved sprint
  • not in — issues that do not belong to the resolved sprint (also includes issues with no sprint assigned)

Examples​

Find issues in the current sprint​

issue in currentSprint("My Scrum Board")

Find issues from the previous sprint​

issue in previousSprint("My Scrum Board")

Find issues in the next upcoming sprint​

issue in nextSprint("My Scrum Board")

Find issues NOT in the current sprint​

issue not in currentSprint("My Scrum Board")

This returns all issues that are either in a different sprint or have no sprint assigned.

Combine with other filters​

issue in currentSprint("Dev Board") AND status = "In Progress"
issue not in previousSprint("Dev Board") AND project = DEV

Notes​

  • The board name must be an exact match (case-sensitive). If no board matches, the function returns an empty result set.
  • currentSprint resolves to the board's single active sprint. If no sprint is active, it returns an error.
  • previousSprint resolves to the most recently closed sprint on the board. If no sprints have been closed, it returns an error.
  • nextSprint resolves to the nearest future (not yet started) sprint. If no future sprints exist, it returns an error.
  • Sprint values are recalculated hourly and whenever sprint state changes (started, closed, created, deleted) to keep results up to date.