Creating a project (classic)

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

In this article

Note

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

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

You can link up to twenty-five repositories to your organization or user-owned project (classic). Linking repositories makes it easier to add issues and pull requests from those repositories to your project (classic) 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 project (classic), 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 project (classic) 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 (classic). For more information, see "Mutations."

Creating a user-owned project (classic)

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

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

  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 Projects (classic)

  4. Click New Project.

  5. Type a name and description for your project (classic).

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

  7. Under "Visibility", choose to make your project (classic) public or private.

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

  9. Click Create project.

  10. On your new project (classic), 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 (classic), in the upper-right corner of the column, click .

Creating an organization-wide project (classic)

Note: Organization owners can control the ability of organization members to create public projects and projects (classic), or change the visibility of existing projects and projects (classic) to public. For more information, see "Allowing project visibility changes in your organization."

  1. In the upper-right corner of GitHub, select your profile photo, then click Your organizations.

  2. Click the name of your organization.

  3. Under your organization name, click Projects.

    Screenshot of the horizontal navigation bar for an organization. A tab, labeled with a table icon and "Projects," is outlined in dark orange.

  4. Click Projects (classic)

  5. Click New Project.

  6. Type a name and description for your project (classic).

  7. Optionally, to add a template to your project (classic), use the Template: drop-down menu and click a template.

  8. Under "Visibility", choose to make your project (classic) public or private.

  9. Optionally, under Linked repositories, search for a repository you'd like to link to your project (classic).

  10. Click Create project.

  11. On your new project (classic), to add your first column, Add a column.

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

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

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

  15. Click Create column.

  16. Add columns to best suit your workflow.

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

Creating a repository project (classic)

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

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

Further reading