Beginner
How to set up Kanban board on Jira
Quick Answer
Setting up a Kanban board in Jira involves creating a new board from your project settings, selecting the Kanban template, and configuring columns to match your workflow. You can customize swimlanes, WIP limits, and filters to optimize your team's task management process.
Prerequisites
- Active Jira account with project creation permissions
- Basic understanding of Kanban methodology
- Existing Jira project or ability to create new one
1
Navigate to Your Jira Project
Log into your Jira instance and navigate to the project where you want to create the Kanban board. If you don't have a project yet, click Create Project from the main dashboard and select a suitable template like Kanban software development or Team-managed project.
Tip
Choose a team-managed project for more flexibility in customizing your Kanban board settings.
2
Create a New Board
From your project sidebar, click Boards and then select Create board. Choose Create a Kanban board from the options. You can either create a board from an existing project or create a new project with a board. Select Board from an existing project if you're adding to your current project.
Tip
If you don't see the Boards option in the sidebar, look for it under the project settings or main navigation menu.
3
Configure Board Settings
Give your board a meaningful name and select the project you want to associate it with. Choose which issues to include by setting up a Filter - you can use the default filter or create a custom JQL (Jira Query Language) filter. Click Create board to proceed.
Tip
Use descriptive board names like 'Marketing Team Sprint Board' or 'Bug Tracking Kanban' for easy identification.
4
Customize Columns
Click on Board settings (gear icon) and select Columns. Add, remove, or rename columns to match your workflow. Common Kanban columns include: To Do, In Progress, Review, and Done. Map each column to the appropriate workflow statuses by dragging statuses into the correct column sections.
Tip
Keep your columns simple initially - you can always add more specific workflow stages later as your process evolves.
5
Set Work in Progress (WIP) Limits
In the Columns section of board settings, set WIP limits for each column by entering a number in the Maximum issues field. This prevents bottlenecks by limiting how many tasks can be in each stage simultaneously. Click Save to apply the limits.
Tip
Start with conservative WIP limits (2-3 items per person per column) and adjust based on your team's capacity and workflow.
6
Configure Swimlanes (Optional)
Go to Board settings > Swimlanes to organize your board horizontally. You can group issues by Assignee, Priority, Epic, or create custom JQL queries for swimlanes. Enable Show for your preferred swimlane option and configure the settings as needed.
Tip
Swimlanes by assignee work well for small teams, while epic-based swimlanes are great for feature tracking.
7
Set Up Quick Filters
In Board settings > Quick filters, create filters for common views like My issues, High priority, or Bugs. Click Add quick filter, provide a name and JQL query such as
assignee = currentUser() for 'My issues', then save your configurations.Tip
Quick filters help team members focus on relevant work without cluttering the board view.
8
Finalize and Share Your Board
Review your board configuration and make any final adjustments. Share the board URL with your team members or add them to the project with appropriate permissions. You can find the board under Boards in your project navigation, and team members can bookmark it for quick access.
Tip
Consider creating a board tour or documentation for new team members to understand your specific workflow and conventions.
Troubleshooting
Cannot see the 'Create board' option
Check your project permissions - you need Administer Projects permission. Contact your Jira administrator if you don't have access, or ask them to create the board for you.
Issues not appearing on the Kanban board
Verify your board filter settings in Board settings > General. Ensure the JQL filter includes the issue types and projects you want to see. Check that issues have the correct status mapped to your columns.
WIP limits not working or showing
WIP limits only apply to columns mapped to In Progress category statuses. Go to Board settings > Columns and ensure your columns are properly mapped to workflow statuses, then re-enter the WIP limit values.
Board appears empty after creation
Create some issues in your project first, or modify the board filter to include existing issues. Go to Board settings > General and adjust the filter query to
project = YOUR_PROJECT_KEY to show all issues in your project.Ready to get started with Jira?
Put this tutorial into practice. Visit Jira and follow the steps above.
Visit Jira →