{"id":16366437,"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=16366437"},"modified":"2025-12-13T06:36:29","modified_gmt":"2025-12-13T06:36:29","slug":"comment-link-block","status":"publish","type":"helphub_article","link":"https:\/\/wordpress.org\/documentation\/article\/comment-link-block\/","title":{"rendered":"Comments Link block"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">The Comments Link block displays a link to the comments section for the current post or page. You can customize the link text and optionally include the total number of comments. This block is most useful in single post\/page templates or inside a Post Template within a Query Loop.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Where you can use this block<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Single posts and pages.<\/li>\n\n\n\n<li>Post Template inside a Query Loop (for example, on an index or archive template).<\/li>\n\n\n\n<li>The block requires post context. It does not display on non-singular pages without a current post.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Add the Comments Link block<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open a post, page, or template in the editor.<\/li>\n\n\n\n<li>Place your cursor where you want the link to appear (for example, under the post title or byline).<\/li>\n\n\n\n<li>Click the + Block Inserter and search for \u201cComments Link,\u201d then select it.\n<ul class=\"wp-block-list\">\n<li>Tip: You can also type \/comments-link on a new line to insert it quickly.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Behavior notes<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>If comments are disabled for the current post or the post is password-protected, the link may be hidden or disabled depending on your discussion settings.<\/li>\n\n\n\n<li>When used in a Query Loop, each Comments Link points to the corresponding post\u2019s comments section.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Block toolbar <\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The block toolbar displays several tools used to customize each block. When you select the&nbsp;<strong>Comments Link <\/strong>block, it will show the block toolbar that contains the following tools:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Transform to<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Click on the \u201cTransform\u201d button to convert the <em>Comments Link<\/em> block into a \u201cGroup\u201d, \u201cColumns\u201d, &#8220;Details&#8221;, or &#8220;Comments Count&#8221; block.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1636\" height=\"670\" src=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-transform-1.png\" alt=\"The Transform button in the Comment Link Block is selected and shows options to transform to Group, Columns, Details, or Comments count\" class=\"wp-image-16366444\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-transform-1.png 1636w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-transform-1-300x123.png 300w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-transform-1-1024x419.png 1024w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-transform-1-768x315.png 768w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-transform-1-1536x629.png 1536w\" sizes=\"auto, (max-width: 1636px) 100vw, 1636px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Drag icon<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">To drag and drop the block to a new location, click and hold the rectangle of dots, then drag it to the new location. The blue separator line indicates where the block will be placed. Release the left mouse button when you find the new location to place the block.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"239\" src=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-drag-1-1024x239.png\" alt=\"The Drag and Drop icon is clicked and highlighted.\" class=\"wp-image-16366443\" style=\"width:763px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-drag-1-1024x239.png 1024w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-drag-1-300x70.png 300w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-drag-1-768x179.png 768w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-drag-1.png 1348w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Move arrows<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The up and down arrow icons can be used to move the block up and down on the page.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"232\" src=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-move-arrows-1024x232.png\" alt=\"The Up and Down arrows of the Comments Link block is selected.\" class=\"wp-image-16366442\" style=\"width:801px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-move-arrows-1024x232.png 1024w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-move-arrows-300x68.png 300w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-move-arrows-768x174.png 768w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-move-arrows.png 1494w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"has-background wp-block-paragraph\" style=\"background-color:#e5f4fa\">Detailed instructions on moving a block within the editor can be found <a href=\"https:\/\/wordpress.org\/support\/article\/moving-blocks\/\">here<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Align<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Use the change alignment tool to align the <em>Comments link <\/em>block. Choose one of the following options:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Align text left<\/strong><\/li>\n\n\n\n<li><strong>Align text right<\/strong><\/li>\n\n\n\n<li><strong>Align text center<\/strong><\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"343\" src=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-align-1024x343.png\" alt=\"The Alignment Tool of the Comment Link block is selected and highlighted.\" class=\"wp-image-16366445\" style=\"aspect-ratio:2.9855453350854138;width:737px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-align-1024x343.png 1024w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-align-300x100.png 300w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-align-768x257.png 768w, https:\/\/wordpress.org\/documentation\/files\/2025\/11\/comment-link-align.png 1332w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Block Settings<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">WordPress blocks have specific configuration options in the block settings panel. To access the&nbsp;<strong>Comments Link&nbsp;<\/strong>block settings panel, click the&nbsp;<strong>Settings<\/strong>&nbsp;button at the top-right corner of the WordPress editor. Alternatively, click the&nbsp;<strong>More options<\/strong>&nbsp;or three dots icon in the&nbsp;<strong>Comments Link <\/strong>block toolbar and select&nbsp;<strong>Show more settings<\/strong>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Color<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The&nbsp;<strong>Comments Link&nbsp;<\/strong>block provides Color settings options to change the text and background colors.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For details refer to this support article:&nbsp;<a href=\"https:\/\/wordpress.org\/documentation\/article\/colors-settings-overview\/\">Color settings overview<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Typography<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The&nbsp;<strong>Comments Link<\/strong>&nbsp;block provides typography settings to change the font family, appearance, line height, letter spacing, decoration, letter case, and font size.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For details refer to this support article:&nbsp;<a href=\"https:\/\/wordpress.org\/documentation\/article\/typography-settings-overview\/\">Typography settings overview<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Dimensions<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The&nbsp;<strong>Comments Link<\/strong>&nbsp;block provides dimension settings options to add padding and margin.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For details refer to this support article:&nbsp;<a href=\"https:\/\/wordpress.org\/documentation\/article\/dimension-controls-overview\/\">Dimension settings overview<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Border<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The&nbsp;<strong>Comments Link<\/strong>&nbsp;block provides border settings options to add border color, width, and radius.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For details refer to this support article:&nbsp;<a href=\"https:\/\/wordpress.org\/documentation\/article\/border-settings-overview\/\">Border settings overview<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Advanced<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The&nbsp;<strong>Advanced<\/strong>&nbsp;section allows you to add CSS class(es) to the&nbsp;<strong>Comments Link<\/strong>&nbsp;block. Therefore, you can insert custom CSS styles into the block.<\/p>\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;padding-top:var(--wp--preset--spacing--20);padding-right:var(--wp--preset--spacing--20);padding-bottom:var(--wp--preset--spacing--20);padding-left:var(--wp--preset--spacing--20)\">\n<h2 class=\"wp-block-heading has-medium-font-size\">Changelog<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Created 2025-12-02<\/li>\n<\/ul>\n<\/div>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>The Comments Link block displays a link to the comments section for the current post or page. You can customize the link text and optionally include the total number of comments. This block is most useful in single post\/page templates or inside a Post Template within a Query Loop. Where you can use this 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":[80,91],"class_list":["post-16366437","helphub_article","type-helphub_article","status-publish","hentry","category-customization","category-theme-blocks"],"revision_note":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16366437","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=16366437"}],"version-history":[{"count":9,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16366437\/revisions"}],"predecessor-version":[{"id":16366618,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16366437\/revisions\/16366618"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/media?parent=16366437"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/category?post=16366437"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}