During team and company planning events like Program Increments (PI), Big Room, Roadmapping and Sprints, development teams discuss and align with each other.
With the Planner widget, facilitators and teams can run and participate in planning events on a Miro board, while also syncing updates to their Jira board in real-time — saving hours of manual work.
Available for: Business Plan, Enterprise Plan
How to create a Planner widget
- Go to the creation toolbar on the left side of your board
- Click More apps (+) and search ‘Planner’
- Click Planner
- A cursor will appear on the board. Click anywhere to place a blank planner widget
- Click the Jira board dropdown and select a board to connect to the planner. If you haven’t yet authorized your Jira account in Miro, you'll be prompted to log in
- The first Columns field is your column type. After selecting the Jira board, the column type will default to Status, and will show up to 3 columns. Click the first Columns field to select a different column type from the dropdown (You can choose Sprint, Status, Priority, Fix versions, Components, or a custom field)
- Use the second Columns field to further refine your Planner widget. For example, if you've picked 'Sprint' as your Column field, you can then select which sprints to display in your Planner widget
✏️ Currently the Planner widget only supports one Jira board. However, you can create multiple Planner widgets on a single Miro board.
Creating a Planner widget with Sprints
How to work with the Planner widget
💡 We're in the process of making Planner widgets fully editable.
Drag Jira cards across columns to update them. For example, dragging a Jira card from the backlog to a sprint in the Planning widget will update it in both Miro and Jira.
Moving Jira cards between sprints
Get an overall view of issue types. Click the Filter issues dropdown and select which issue types to display in your Planner widget. For example, you can filter by Story only. Filtering by issue type
Participants can comment on Jira cards to track ongoing discussions and notes.
Commenting on a Jira card in the Planner widget
✏️ Miro cards, sticky notes and other widgets cannot be placed within a Planner widget.
Capacity and load
Make informed prioritisation decisions during Sprint and PI planning by visualizing story point totals in easy-to-read columns. Boost your team's efficiency and ensure optimal work distribution.
Enable the story points field in Jira cards
- Go to the creation toolbar on the left side of your board
- Click More apps (+) and search ‘Jira cards’
- Open the Jira cards app
- Click Configure cards
- Search for and toggle on Story Points
Enabling story points for Jira cards
Using Capacity and Load
Once you enable story points, you can create a new Planner widget or refresh a board with an existing Planner widget. As long as at least one issue on the board has assigned story points, you'll instantly see the Capacity and Load fields at the top of each column in your Planner widget.Balancing capacity and load
Understanding Capacity and Load
Capacity: Manually input the capacity for each column in your Planner widget. If the capacity is less than the load, the column will turn red, signaling that you have exceeded your team's capacity. This visual cue prompts you to consider reallocating issues to maintain a balanced workload.
Load: This represents the sum of story points for all cards in a given column. Cards without story points will count as 0 in this calculation.
Jira configuration
To set up the Planner widget, start by picking a Jira board to import issues from. This can either be from a Jira Scrum or Kanban board.
When creating a Planner widget you can choose which Jira field to use for your columns, including:
- Sprints
- Status
- Fix version
- Component
- Priority
- Any custom field with a single value dropdown selection
- Any custom field with a multi-value dropdown selection
We do not currently support other Jira fields like assignee or date-related fields.
The Sprint option will only appear if the sprint field is available on the edit issue screen in Jira. This is commonly pre-configured for Jira Server/Data Center but often Cloud requires the sprint field to be added manually. Read more about how to configure issue screens.
How to create a Planner widget using a custom JQL
To make a Planner widget using a custom JQL, start by making a Jira board with your JQL query. After the Jira board is created, follow the instructions above for creating a Planner widget. When you get to step 5, remember to choose the Jira board you created using your customized JQL query.
Planner widget syncing
From Miro to Jira
When you drag a card between custom fields in Miro, Jira is updated automatically. This may take a few seconds.
From Jira to Miro
💡 Automatic sync from Jira to Miro is coming soon.
If you make changes to a sprint in Jira, you'll see an Updates available notification in the Planner widget context menu. This may take a few seconds after you make the changes in Jira.
Click the Planning widget to open the context menu, and click the Sync with Jira icon to sync the latest changes.
Syncing updates from Jira to Miro
Dependency mapping
Participants can visually map dependencies between tasks on the Planner widget. Learn more about our Dependencies app.