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.
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 Plan mode 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:
- Click the Agile link's down-arrow in the top navigation bar, then select your preferred board from the resulting dropdown menu.
- Your board will be displayed. Click Plan.
- 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
If you are using JIRA Agile 6.3.4 or later, you can add existing issues to an active sprint, using the Work mode 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 create and add a new issue to an active sprint:
- Click the Agile link's down-arrow in the top navigation bar, then select your preferred board from the resulting dropdown menu.
- Your board will be displayed. Click Work.
- Click Create issue in the header to create the issue and complete the issue details, as desired.
- 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:
- (6.3.9 and later) 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.
Note, 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, click the sprint name and check the URL for number in the sprint parameter.
Note, you will only be able to choose from active or future sprints, i.e. closed/completed sprints will not be available for selection.
Screenshot: Editing the Sprint field for an issue
