{"id":16366378,"date":"2025-12-02T20:00:00","date_gmt":"2025-12-02T20:00:00","guid":{"rendered":"https:\/\/wordpress.org\/documentation\/?post_type=helphub_article&#038;p=16366378"},"modified":"2025-12-01T21:37:08","modified_gmt":"2025-12-01T21:37:08","slug":"notes","status":"publish","type":"helphub_article","link":"https:\/\/wordpress.org\/documentation\/article\/notes\/","title":{"rendered":"Notes"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Notes let you and your team leave contextual feedback directly on individual blocks while editing a post or page. You can add notes, reply in threads, resolve conversations when they\u2019re done, and keep collaboration inside WordPress. Notes never appear on the frontend of your site. Currently, Notes can only be added on a per block basis, meaning you can&#8217;t add notes for an individual item with a block. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What you need<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>WordPress 6.9 or later.<\/li>\n\n\n\n<li>A user role that can edit the post or page (see \u201cPermissions and visibility\u201d below).<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Where Notes are available<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Post and page editors.<\/li>\n\n\n\n<li>Notes are not shown on the frontend and are not available in the Site Editor (templates, template parts) in WordPress 6.9.<\/li>\n\n\n\n<li>Custom post types can support Notes if enabled by a theme or plugin author. If you don\u2019t see Notes on a custom post type you use, please follow <a href=\"https:\/\/make.wordpress.org\/core\/2025\/11\/15\/notes-feature-in-wordpress-6-9\/\">these instructions<\/a> to add support. <\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">How to use notes<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Add a note<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open a post or page in the block editor.<\/li>\n\n\n\n<li>Select the block you want to discuss.<\/li>\n\n\n\n<li>In the toolbar, select the three dot menu, and choose &#8220;Add Note&#8221;<\/li>\n\n\n\n<li>Type your message and submit to create the note.<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"3018\" height=\"1550\" src=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/Add-note.png\" alt=\"Block toolbar opened with an arrow pointing to the Add Note option.\" class=\"wp-image-16366382\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/Add-note.png 3018w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/Add-note-300x154.png 300w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/Add-note-1024x526.png 1024w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/Add-note-768x394.png 768w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/Add-note-1536x789.png 1536w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/Add-note-2048x1052.png 2048w\" sizes=\"auto, (max-width: 3018px) 100vw, 3018px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Reply to a note<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Open the note thread attached to the block or from the Notes panel and add your reply. Replies stay threaded with the original note.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Edit or delete your note<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Select the note you want to edit or delete.<\/li>\n\n\n\n<li>Select the three dot menu in the note.<\/li>\n\n\n\n<li>This will reveal two options: edit or delete.<\/li>\n\n\n\n<li>Select which option you want and proceed to edit or delete. Deleting a note removes it from the thread. <\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"3010\" height=\"1424\" src=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/Edit-or-delete-note.png\" alt=\"\" class=\"wp-image-16366383\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/Edit-or-delete-note.png 3010w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/Edit-or-delete-note-300x142.png 300w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/Edit-or-delete-note-1024x484.png 1024w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/Edit-or-delete-note-768x363.png 768w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/Edit-or-delete-note-1536x727.png 1536w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/Edit-or-delete-note-2048x969.png 2048w\" sizes=\"auto, (max-width: 3010px) 100vw, 3010px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Resolve and reopen a note<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">To resolve, follow these steps:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Select the note you want to resolve.<\/li>\n\n\n\n<li>Select the check option. This will resolve the note. <\/li>\n\n\n\n<li>Resolved notes are hidden from active views but remain available in the post\u2019s history for reference.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">To reopen a resolved note, follow these steps:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Select the dedicated Notes view in the top toolbar. This displays all notes, including any that were resolved.<\/li>\n\n\n\n<li>Select the note you want to reopen. <\/li>\n\n\n\n<li>Write a new note in the text field and then select &#8220;Reopen and reply&#8221;. <\/li>\n\n\n\n<li>This will reopen the note with your new message. <\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-video\"><video height=\"1558\" style=\"aspect-ratio: 3022 \/ 1558;\" width=\"3022\" controls src=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/reopen-note.mov\"><\/video><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">View notes for a block<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>If a block has a note attached, you&#8217;ll see an indication in the block toolbar that shows the users avatar. <\/li>\n\n\n\n<li>Select the avatar and it will display related notes. <\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Otherwise, you can also select the dedicated Notes view in the top toolbar. This displays all notes, including any that were resolved, and you can select different notes to see their respective blocks. <\/p>\n\n\n\n<figure class=\"wp-block-video\"><video height=\"1548\" style=\"aspect-ratio: 3018 \/ 1548;\" width=\"3018\" controls src=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/viewing-notes.mov\"><\/video><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Email notifications<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>By default, the post author receives an email when another user leaves a new note on their post.<\/li>\n\n\n\n<li>To change this behavior, go to Settings &gt; Discussion and adjust \u201cEmail me whenever &gt; Anyone posts a note.\u201d<\/li>\n\n\n\n<li>Site administrators can fine-tune notifications with plugins or custom code by <a href=\"https:\/\/make.wordpress.org\/core\/2025\/11\/15\/notes-feature-in-wordpress-6-9\/\">following these instructions<\/a>. End users can ask an administrator if they need different notification behavior.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Permissions and visibility<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Only users who can edit a post can see or add notes on that post.\n<ul class=\"wp-block-list\">\n<li>Administrators and Editors: can view and add notes on all posts.<\/li>\n\n\n\n<li>Authors and Contributors: can view and add notes on their own posts.<\/li>\n\n\n\n<li>Subscribers: cannot view or add notes.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Notes are internal to your site and never appear to visitors.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Tips for effective collaboration<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Use one note per topic to keep conversations focused.<\/li>\n\n\n\n<li>Resolve notes when tasks are complete to reduce clutter.<\/li>\n\n\n\n<li>Use replies instead of creating new notes when continuing the same conversation.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Demo<\/h2>\n\n\n\n<figure class=\"wp-block-video\"><video height=\"2160\" style=\"aspect-ratio: 3840 \/ 2160;\" width=\"3840\" controls src=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/6-9-notes-i0.mp4\"><\/video><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Troubleshooting<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>I don\u2019t see Notes:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Confirm the site is running WordPress 6.9 or later.<\/li>\n\n\n\n<li>Make sure you\u2019re editing a post or page (Notes are not available in templates in 6.9).<\/li>\n\n\n\n<li>Verify you\u2019re logged in and have permission to edit the post.<\/li>\n\n\n\n<li>Open the Notes panel in the editor sidebar, or select a block and look for the Notes control in the toolbar.<\/li>\n\n\n\n<li>Temporarily disable plugins or switch themes to rule out conflicts.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Team members aren\u2019t getting emails:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Check Settings &gt; Discussion: \u201cEmail me whenever &gt; Anyone posts a note\u201d must be enabled.<\/li>\n\n\n\n<li>Verify the user is the post author or ask an administrator to customize notification behavior if different recipients are needed.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Notes on my custom post type are missing:<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Please follow <a href=\"https:\/\/make.wordpress.org\/core\/2025\/11\/15\/notes-feature-in-wordpress-6-9\/\">these instructions<\/a> to add support. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Frequently asked questions<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Do notes show on the live site?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">No. Notes are only visible in the editor to users who can edit the post.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Can I leave a note on part of a paragraph or selected text?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">In WordPress 6.9, notes attach to entire blocks, not specific items within a block. This is a planned enhancement for the future. <\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Can I see all notes assigned to me?<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">WordPress 6.9 does not include user assignment or mentions in Notes. Your site may add similar features via plugins.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">For site owners and developers<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Notes are on by default for posts and pages. Custom post types can add support programmatically.<\/li>\n\n\n\n<li>Notification and other behaviors can be customized with existing comment-related filters.<\/li>\n\n\n\n<li>Technical details are available in the <a href=\"https:\/\/make.wordpress.org\/core\/2025\/11\/15\/notes-feature-in-wordpress-6-9\/\">WordPress 6.9 developer note<\/a> for this feature. <\/li>\n<\/ul>\n\n\n\n<div id=\"changelog\" class=\"wp-block-group changelog has-background is-layout-flow wp-block-group-is-layout-flow\" style=\"background-color:#dce5ec\">\n<h2 class=\"wp-block-heading\"><strong>Changelog:<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Created 2025-11-27<\/li>\n<\/ul>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Notes let you and your team leave contextual feedback directly on individual blocks while editing a post or page. You can add notes, reply in threads, resolve conversations when they\u2019re done, and keep collaboration inside WordPress. Notes never appear on the frontend of your site. Currently, Notes can only be added on a per block [&hellip;]<\/p>\n","protected":false},"author":13782018,"featured_media":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"advanced_seo_description":"","jetpack_seo_html_title":"","jetpack_seo_noindex":false},"category":[83,80],"class_list":["post-16366378","helphub_article","type-helphub_article","status-publish","hentry","category-block-editor","category-customization"],"revision_note":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16366378","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles"}],"about":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/types\/helphub_article"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/users\/13782018"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/comments?post=16366378"}],"version-history":[{"count":1,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16366378\/revisions"}],"predecessor-version":[{"id":16366386,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16366378\/revisions\/16366386"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/media?parent=16366378"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/category?post=16366378"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}