Adding an Issue to a Sprint

Once you have identified that an issue is due to be actioned, you will need to add it to a sprint. You can either add an issue to a future sprint, or to the sprint that is currently in progress (the active sprint).

There are three different methods for adding an issue to a sprint.

  • Add existing issues to a sprint — Use this when the issue already exists, and you want to add the issue to an active or future sprint.
  • Create and add a new issue to an active sprint — Use this when the issue does not exist, and you want to quickly add it to an active sprint.
  • Edit the Sprint field for an issue — Use this when editing an issue, and you know the name of the sprint.

(info) Please note:

  • This page only applies to Scrum boards.

  • Sub-tasks cannot be moved independently of their parents.
  • You will need to have the 'Edit Issue' permission in the project to which the issue belongs.
  • If you are moving the issue above or below other issues, you will need to have the 'Schedule Issue' permission in the project to which the issue belongs.

Adding an existing issue to a sprint

You can add existing issues to an active or future sprint, using the Backlog of a board. Please note:

  • adding an issue to an active sprint will be shown as a 'scope change' event on the Burndown Chart for that sprint.
  • adding an issue to a sprint on one board will affect all other boards which contain that issue.

To add an existing issue to a sprint:

  1. Click the Agile link's down-arrow in the top navigation bar, then select your preferred board from the resulting dropdown menu.

  2. Click Backlog.
  3. Select the issue(s) (use Shift+Click or Ctrl+Click) and right-click, then select the relevant sprint (see screenshot below).
    Alternatively, you can drag-and-drop individual issues onto the relevant sprint.

Screenshot: right-clicking an issue to send it to a sprint

Creating and adding a new issue to an active sprint

You can add existing issues to an active sprint, using the Active sprints of a board. Please note:

  • adding an issue to an active sprint will be shown as a 'scope change' event on the Burndown Chart for that sprint.
  • adding an issue to a sprint on one board will affect all other boards which contain that issue.
  • you must have the 'Administer Projects' permission for the projects included by the board's filter, otherwise the issue will be added directly to the backlog.

To create and add a new issue to an active sprint:

  1. Click the Agile link's down-arrow in the top navigation bar, then select your preferred board from the resulting dropdown menu.

  2. Click Active sprints.
  3. Click Create issue in the header to create the issue and complete the issue details, as desired.
  4. After creating the issue, a confirmation dialog will display. In the dialog, click Add to <sprint name> where <sprint name> is the name of the sprint that you are currently viewing on the board.

Screenshot: confirmation dialog with link to add new issue to current sprint

Editing the Sprint field for an issue

You can add issues to a sprint by doing the following:

  • Edit the Sprint field for a single issue: Add an issue to a sprint by creating/editing the issue and updating the Sprint field. The Sprint field is available when creating/editing the issue in both JIRA and JIRA Agile. Note:
    • You may need to show the field on the 'Create Issue'/'Edit Issue' dialog — choose Configure Fields then select the Sprint field.
    • You will only be able to choose from active or future sprints, i.e. closed/completed sprints will not be available for selection. 
    • You can edit the Sprint field in JIRA Agile 6.3.8.x and earlier, but you will need to configure your edit issue screen to show the Sprint field. Also, the Sprint field will not allow for searching by name — you will need to enter the Sprint ID.
  • Edit the Sprint field for multiple issues: Bulk edit issues and update the Sprint field, to add multiple issues to a sprint. Note, bulk edit currently does not allow you to search for Sprint by name, so you will need to enter the sprint ID. To find the Sprint ID, navigate to an issue in the sprint, hover over the sprint name and look in the URL for the number in the sprint parameter. 

Screenshot: Editing the Sprint field for an issue

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport