Skip to main content

About projects (classic)

Projects (classic) on GitHub help you organize and prioritize your work.

Note

Creation of new projects (classic) is now disabled. Projects (classic) will be sunset and removed on August 23, 2024. You can read more about this change on the GitHub Blog.

The new and improved Projects experience is available. For more information, see "About Projects."

On August 23, 2024, all remaining projects (classic) will be automatically migrated before the feature is removed.

Projects (classic) are made up of issues, pull requests, and notes that are categorized as cards in columns of your choosing. You can drag and drop or use keyboard shortcuts to reorder cards within a column, move cards from column to column, and change the order of columns.

Project (classic) cards contain relevant metadata for issues and pull requests, like labels, assignees, the status, and who opened it. You can view and make lightweight edits to issues and pull requests within your project (classic) by clicking on the issue or pull request's title.

You can create notes within columns to serve as task reminders, references to issues and pull requests from any repository on GitHub.com, or to add information related to the project (classic). You can create a reference card for another project (classic) by adding a link to a note. If the note isn't sufficient for your needs, you can convert it to an issue. For more information on converting notes to issues, see "Adding notes to a project (classic)."

Types of projects (classic):

  • User-owned project (classic) can contain issues and pull requests from any personal repository.
  • Organization-wide project (classic) can contain issues and pull requests from any repository that belongs to an organization. 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)."
  • Repository project (classic) are scoped to issues and pull requests within a single repository. They can also include notes that reference issues and pull requests in other repositories.

Viewing projects (classic)

If an organization-owned project (classic) includes issues or pull requests from a repository that you don't have permission to view, the card will be redacted. For more information, see "Project (classic) permissions for an organization."

The activity view shows the project (classic)'s recent history, such as cards someone created or moved between columns. To access the activity view, click Menu and scroll down.

To find specific cards on a project (classic) or view a subset of the cards, you can filter project (classic) cards. For more information, see "Filtering cards on a project (classic)."

To simplify your workflow and keep completed tasks off your project (classic), you can archive cards. For more information, see "Archiving cards on a project (classic)."

If you've completed all of your project (classic) tasks or no longer need to use your project (classic), you can close the project (classic). For more information, see "Closing a project (classic)."

You can also disable projects (classic) in a repository or disable projects (classic) in your organization, if you prefer to track your work in a different way.

Further reading