YouTrack Standalone 2021.1 Help

Create an Agile Board

You can create an agile board in YouTrack and customize its settings to support different agile methodologies. Whether you follow scrum, kanban, a combination of the two, or a concoction that is only known to your imagination, YouTrack's agile boards are flexible enough to accommodate.

You can create and share a board with your team, or build a personal board to manage your own work.

Permissions

The only permission that is actually required to create an agile board in YouTrack is Read Issue. As long as you have permission to read issues, you can create a board and monitor the progress of issues in the project. For example, users with the default Issue Reader role in a project can create a board and use it to track issues. However, this role has a limited set of permissions. Their ability to interact with issues on the board is restricted.

To create and configure a board that you and your team can use to update issues in a project, you need permission to perform a wider range of actions. If you encounter any problems when you follow this setup, check that you have access to the following permissions:

ActionPermission
Add projects to the board.The list of projects is restricted to projects where you have the Read Issue permission. Read Project permission is not required.
Let other users view and use the board.Requires Read Group.
Add issues to the board.Requires Create Issue.

The Can view and use the board and Can edit board settings options set the visibility for your board. When both options are set to Owner, your board is private. However, if you use the Can view and use the board option to restrict the visibility of the board, users with the Low-level Administration permission can access and edit the settings for this board as well.

Creating a Board

This procedure walks you through the basic steps. For more detail, browse the other topics in this section of the documentation.

To create an agile board:

  1. Click the Agile Boards link in the header.

    • If you already have access to one or more boards, the board that you last viewed is displayed.

    • If you don't have access to any of the boards in your installation, the Create an Agile Board page opens immediately. If this is the case, skip to step 3 and select a template for your board.

  2. Click the Create button, and select Board.

    Agile board create menu

  3. Select a template:

    Agile templates
    TemplateDescription
    Scrum boardPre-configured for scrum development teams. Automatically set for tracking feature development over a series of scheduled sprints.
    Kanban boardPre-configured for teams that follow a kanban methodology. Also a great option for personal boards.
    Version-based boardPre-configured to link sprints to the value in a custom field that stores a version type. Designed to mimic the behavior of agile boards in earlier versions of YouTrack where you can use a query to filter the visibility of cards on the board.
    Custom boardGenerated with a default configuration that you adjust to any work flow.
    Personal boardA kanban-style board that shows only issues that are assigned to the current user.

    For a list of settings that are pre-configured each template, see Agile Board Templates.

    • The New Board page opens.

      New board settings

  4. Enter a name for the new board.

  5. Add projects that you want to manage on the board.

    New board projects

    If you want to manage multiple projects on the board, click the Add all projects where I am team member link. You can add and remove projects as required.

  6. Configure the visibility settings of the board. Select the users and groups and project teams whose members can view and use the board and edit board settings.

    • For the Can view and use the board setting, use the issue readers option to automatically grant read access to any user who has Read Issue permission in the projects that are listed in the Projects setting.

    • For the Can edit board settings setting, use the project updaters option to automatically grant access to any user who has Update Project permission in the projects that are listed in the Projects setting.

    New board visibility

    By default, the Can view and use the board and Can edit board settings settings are set to Owner. This means that the new board is private. However, if you make the board visible to other users, users with the Low-level Administration permission in this group can access and edit the settings for this board as well.

  7. Click the Create board button.

    • The agile board is created and ready for use.

    • YouTrack lets you freely reconfigure your agile boards as you fine-tune and adapt your project management methodologies. If you want to experiment with additional settings, click the icon in the toolbar to expand the Board Settings panel.

      To learn more about the settings for agile boards, see Agile Board Settings.

Last modified: 08 March 2021