You can add notes to a project to serve as task reminders or to add information related to the project.

Tips:

  • You can format your note with simple syntax. For more information, see "Basic writing and formatting syntax."
  • Notes can be moved between and reordered within columns by dragging and dropping them.
  • Notes can't be more than 140 characters.

Adding notes to a repository project

  1. On GitHub, navigate to the main page of the repository.

  2. Under your repository name, click Projects. Project tab

  3. In the projects list, click the project you want to add notes to. Make sure your project has at least one column. For more information on adding columns to your project, see "Creating a project." Select project

  4. In the column you want to add a note to, click . Plus icon
  5. Type your note and click Add note. Add note button

Adding notes to an organization-wide project

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

  2. On the left side of your profile page, under "Organizations", click the icon for your organization. organization icons

  3. Under your organization name, click Projects. Projects tab for your organization

  4. In the projects list, click the project you want to add notes to. Select project

  5. In the column you want to add a note to, click . Plus icon
  6. Type your note and click Add note. Add note button

Converting a note to an issue

If you've created a note and find that it isn't sufficient for your needs, you can convert it to an issue.

When you convert a note to an issue, the issue is automatically created using the content from the note. The first line of the note will be the issue title and any additional content from the note will be added to the issue description.

Tip: You can add content in the body of your note to @mention someone, link to another issue or pull request, and add emoji. These GitHub Flavored Markdown features aren't supported within project notes, but once your note is converted to an issue, they'll appear correctly. For more information on using these features, see "About writing and formatting on GitHub."

  1. Navigate to the note that you want to convert to an issue.
  2. Click . Chevron icon for more options
  3. Click Convert to issue. Convert to issue button
  4. Pick the repository you want to add the issue to.
  5. Confirm that you want to convert the note to an issue by clicking OK.
  6. The note is automatically converted to an issue within the repository. In the project, the new issue card will be in the same location as the previous note.

Editing and removing a note

  1. Navigate to the note that you want to edit or remove.
  2. Click . Chevron icon for more options
  3. Click Edit note to edit the contents of the note. Edit note button
  4. Click Delete note to delete the note from the Project. Delete note button

Further reading