Skip to main content

This version of GitHub Enterprise was discontinued on 2023-07-06. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Creating a project board

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.

You can use a project board template to create a project board with automation already configured. For more information, see "About project boards."

You can link up to twenty-five repositories to your organization or user-owned project board. Linking repositories makes it easier to add issues and pull requests from those repositories to your project board using Add cards or from the issue or pull requests sidebar. For more information, see "Linking a repository to a project board."

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."

You can use GitHub's API to import a project board. For more information, see "Mutations."

Creating a user-owned project board

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

  2. On the top of your profile page, in the main navigation, click Projects.

    Screenshot showing profile tabs. The 'Projects' tab is highlighted with an orange outline.

  3. Click New Project.

  4. Type a name and description for your project board.

  5. Optionally, to add a template to your project board, use the Template: drop-down menu and click a template.

  6. Under "Visibility", choose to make your project board public or private. For more information, see "Changing project board visibility."

  7. Optionally, under Linked repositories, search for a repository you'd like to link to your project board.

  8. Click Create project.

  9. On your new project board, to add your first column, Add a column.

  10. Under "Column name", type the name of the column you want to create.

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

  12. Select the workflow automations you want to configure for the column.

  13. Click Create column.

  14. Add columns to best suit your workflow.

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

Creating an organization-wide project board

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

    Screenshot of the dropdown menu under @octocat's profile picture. "Your organizations" is outlined in dark orange.

  2. Click the name of your organization.

  3. Under your organization name, click Projects.

  4. Click New Project.

  5. Type a name and description for your project board.

  6. Optionally, to add a template to your project board, use the Template: drop-down menu and click a template.

  7. Under "Visibility", choose to make your project board public or private. For more information, see "Changing project board visibility."

  8. Optionally, under Linked repositories, search for a repository you'd like to link to your project board.

  9. Click Create project.

  10. On your new project board, to add your first column, Add a column.

  11. Under "Column name", type the name of the column you want to create.

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

  13. Select the workflow automations you want to configure for the column.

  14. Click Create column.

  15. Add columns to best suit your workflow.

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

Creating a repository project board

  1. On your GitHub Enterprise Server instance, navigate to the main page of the repository.
  2. Under your repository name, click Projects.
  3. Click New Project.
  4. Type a name and description for your project board.
  5. Optionally, to add a template to your project board, use the Template: drop-down menu and click a template.
  6. Click Create project.
  7. On your new project board, to add your first column, Add a column.
  8. Under "Column name", type the name of the column you want to create.
  9. Optionally, under "Automation", select an automation preset using the drop-down menu.
  10. Select the workflow automations you want to configure for the column.
  11. Click Create column.
  12. Add columns to best suit your workflow.

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

Further reading