Configure GitHub Projects

• 3 minutes

Create a project

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

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.

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.

You can create custom fields to add to your project.

Manage access and permissions by adding collaborators.

For more information about Projects, see:

• Quickstart for projects - GitHub Docs.
• Creating an issue - GitHub Docs.