Skip to main content

Creating a project (classic)

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

Notes:

  • Projects, the all-new projects experience, is now available. For more information about Projects, see "About Projects" and for information about migrating your classic project, see "Migrating from Projects (classic)."
  • You can only create a new classic project board for an organization, user, or repository that already has at least one classic project board. If you're unable to create a classic project board, create a project board instead.

You can use a classic project template to create a classic project with automation already configured. For more information, see "About projects (classic)."

You can also copy a classic project to reuse its customizations for similar projects. For more information, see "Copying a project (classic)."

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

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

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

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

Creating a user-owned classic project

Note: You can only create a new classic project board for an organization, user, or repository that already has at least one classic project board. If you're unable to create a classic project board, create a beta project board instead. For more information, see "Creating a project (beta)."

  1. In the top right corner of GitHub.com, click your profile photo, then click Your profile. Profile photo
  2. On the top of your profile page, in the main navigation, click Projects. Project tab
  3. Click Projects (classic)
  4. Click New Project. New Project button
  5. Type a name and description for your project board. Fields for project name and description and Create project button
  6. Optionally, to add a template to your project board, use the Template: drop-down menu and click a template. Drop-down menu showing project board template options
  7. Under "Visibility", choose to make your project board public or private. For more information, see "Changing project board visibility." Radio buttons to choose project board visibility
  8. Optionally, under Linked repositories, search for a repository you'd like to link to your project board. Search field to link repositories
  9. Click Create project.
  10. On your new project board, to add your first column, Add a column. Add a column button on an empty project board
  11. Under "Column name", type the name of the column you want to create. Type column name
  12. Optionally, under "Automation", select an automation preset using the drop-down menu. Select preset automation from menu
  13. Select the workflow automations you want to configure for the column. List of options for automating 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 an organization-wide classic project

Note: You can only create a new classic project board for an organization, user, or repository that already has at least one classic project board. If you're unable to create a classic project board, create a beta project board instead. For more information, see "Creating a project (beta)."

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. Your organizations in the profile menu

  2. Click the name of your organization. Organization name in list of organizations

  3. Under your organization name, click Projects.

    Projects tab for your organization

  4. Click Projects (classic)

  5. Click New Project. New Project button

  6. Type a name and description for your project board. Fields for project name and description and Create project button

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

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

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

  10. Click Create project.

  11. On your new project board, to add your first column, Add a column. Add a column button on an empty project board

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

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

  14. Select the workflow automations you want to configure for the column. List of options for automating the column

  15. Click Create column.

  16. 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 classic project

Note: You can only create a new classic project board for an organization, user, or repository that already has at least one classic project board. If you're unable to create a classic project board, create a beta project board instead. For more information, see "Creating a project (beta)."

  1. On GitHub.com, navigate to the main page of the repository.
  2. Under your repository name, click Projects. Project tab
  3. Click Projects (classic)
  4. Click New Project. New Project button
  5. Type a name and description for your project board. Fields for project name and description and Create project button
  6. Optionally, to add a template to your project board, use the Template: drop-down menu and click a template. Drop-down menu showing project board template options
  7. Click Create project.
  8. On your new project board, to add your first column, Add a column. Add a column button on an empty project board
  9. Under "Column name", type the name of the column you want to create. Type column name
  10. Optionally, under "Automation", select an automation preset using the drop-down menu. Select preset automation from menu
  11. Select the workflow automations you want to configure for the column. List of options for automating the column
  12. Click Create column.
  13. 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