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

Tips:

  • You can format your note using Markdown syntax. For example, you can use headings, links, task lists, or emoji. For more information, see "Basic writing and formatting syntax."
  • You can drag and drop or use keyboard shortcuts to reorder notes and move them between columns. For more information about keyboard shortcuts, see "Project boards" in "Using keyboard shortcuts."

  • Your project board must have at least one column before you can add notes. For more information, see "Creating a project board."

When you add a URL for an issue, pull request, or another project board to a note, you'll see a preview in a summary card below your text.

Project board cards showing a preview of an issue and another project board

Adding notes to a repository project board

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

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

  3. In the list of projects, click the project board you want to add notes to. List of project boards

  4. In the column you want to add a note to, click . Plus icon in the column header

  5. Type your note, then click Add. Field for typing a note and Add card button

    Tip: You can reference an issue or pull request in your note by typing its URL in the card.

Adding notes to an organization-wide project board

  1. In the top right corner of GitHub Enterprise, 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 list of projects, click the project board you want to add notes to. List of project boards

  5. In the column you want to add a note to, click . Plus icon in the column header

  6. Type your note, then click Add. Field for typing a note and Add card button

    Tip: You can reference an issue or pull request in your note by typing its URL in the card.

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 board 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. If the card is on an organization-wide project board, in the drop-down menu, choose the repository you want to add the issue to. Drop-down menu listing repositories where you can create the issue

  5. Optionally, edit the pre-filled issue title, and type an issue body. Fields for issue title and body
  6. Click Convert to issue.

  7. The note is automatically converted to an issue. In the project board, 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. To edit the contents of the note, click Edit note. Edit note button

  4. To delete the contents of the notes, click Delete note. Delete note button

Further reading