Add notes to blocks

Add notes to blocks in the WordPress editor to discuss changes, request edits, or keep track of ideas. In this guide, you’ll learn how to add, view, and work with notes while editing your content.

You can leave comments directly in the WordPress editor. Users with the Administrator, Editor, or Author role can create and reply to notes. Notes are visible within the editor only and cannot be seen publicly.

Notes are threaded, can be resolved when a discussion is complete, and reopened at any time if further adjustments are needed. You can keep several separate note threads on the same block, and attach a note to a whole block or to a specific piece of text. When a new note is added to a post or page, the author receives an email notification.

To add a note to a block or piece of text, take the following steps:

1. Edit a page or post.
2. Click on the block or select the specific text you want to add a note to.
3. Click the ⋮ (three dots) icon in the toolbar that appears.
4. Select the “Add note” option.
5. Type your note in the text box.
6. Click the “Add note” button to submit the note.

Notes have the following options:

• Click the checkmark icon to resolve the note. Resolved notes appear under a Resolved divider when viewing all your notes (described below).
• Click the ⋮ icon to Edit or Delete a note.
• Click the Reply button to add a reply to your own note.

Tag a collaborator in a note to direct it to them. You can tag any user with the Administrator, Editor, or Author role on the site.

1. Start a new note or reply to an existing one.
2. Type @ followed by the person’s name.
3. Select the person from the list that appears.

Use the arrow keys to move through the list, and press Enter to select someone. To close the list without tagging anyone, press Esc. This closes only the list, not the note you are writing.

View notes from the block toolbar or from the Notes panel. If a block has notes, you’ll see the profile photo of the person who added the note in the block toolbar. Click the photo to view the note.

To view all notes on a page or post, click the Notes icon (speech bubble) in the upper corner of the editor, next to the Save button. Unresolved notes are shown first, followed by resolved notes.