Project boards can be used to create customized workflows to suit your needs, like tracking and prioritizing specific feature work, comprehensive roadmaps, or even release checklists.

Once you've created your project board, you can add issues, pull requests, and notes to it. For more information, see "Adding issues and pull requests to a project board" and "Adding notes to a project board."

You can also configure workflow automations to keep your project board in sync with the status of issues and pull requests. For more information, see "About automation for project boards."

Creating a repository project board

  1. On GitHub, navigate to the main page of the repository.

  2. Under your repository name, click Projects. Project tab

  3. Click New Project. New Project button

  4. Type a project board name and a description of the project board and click Save Project. Save Project button
  5. Click Add column to add your first column to your project board. Add column button
  6. Under "Column name", type the name of the column you want to create. Type column name

  7. Optionally, under "Automation", select an automation preset using the drop-down menu. Select preset automation from menu

  8. Select the workflow automations you want to configure for the column. Select automation options

  9. Click Create column.

  10. Add additional columns to best suit your workflow.

Tip: To edit or remove a column from your project board, click the three dots in the upper-right corner of the column.

Creating an organization-wide project

  1. In the top right corner of GitHub, click your profile photo, then click Your profile. Profile photo

  2. On the left side of your profile page, under "Organizations", click the icon for your organization. organization icons

  3. Under your organization name, click Projects. Projects tab for your organization

  4. Click New Project. New Project button

  5. Type a project board name and a description of the project board and click Save Project. Save Project button
  6. Click Add column to add your first column to your project board. Add column button
  7. Under "Column name", type the name of the column you want to create. Type column name

  8. Optionally, under "Automation", select an automation preset using the drop-down menu. Select preset automation from menu

  9. Select the workflow automations you want to configure for the column. Select automation options

  10. Click Create column.

  11. Add additional columns to best suit your workflow.

Tip: To edit or remove a column from your project board, click the three dots in the upper-right corner of the column.

Further reading