Configure GitHub Projects

Completed

Create a project

To start working with GitHub Projects, you first need to create an organization or user project.

Screenshot of New GitHub Project (beta) feature.

To create an organization project:

  1. On GitHub, navigate to the main page of your organization.
  2. Click Projects.
  3. Select the New project drop-down menu and click New project.

To create a user project:

  1. On any GitHub page, click on your avatar, then select Your projects.
  2. Select the New project drop-down menu and click New project.

Create a project description or a README file:

  1. Navigate to your project.
  2. In the top-right, click to open the menu.
  3. In the menu, click Settings.
  4. Under Add a description, type your description in the text box and click Save.
  5. To update your project's README, type your content in the text box under README.
  6. Click Save.

Adding issues

When your new project initializes, it prompts you to add items.

Click on the plus (+) sign to add more issues.

Screenshot of GitHub Projects list with empty tasks.

Project settings and permissions

You can view and make quick changes to your project description and README by navigating to your project and clicking on the top right.

Screenshot of GitHub Projects settings.

You can create custom fields to add to your project.

Screenshot of GitHub Projects settings to create custom fields.

Manage access and permissions by adding collaborators.

Screenshot of GitHub Projects settings manage access.

For more information about Projects, see: