{"id":16228384,"date":"2022-11-23T22:16:07","date_gmt":"2022-11-23T22:16:07","guid":{"rendered":"https:\/\/wordpress.org\/support\/?post_type=helphub_article&#038;p=16228384"},"modified":"2026-05-27T04:11:29","modified_gmt":"2026-05-27T04:11:29","slug":"post-template-block","status":"publish","type":"helphub_article","link":"https:\/\/wordpress.org\/documentation\/article\/post-template-block\/","title":{"rendered":"Post Template block"},"content":{"rendered":"\n<p class=\"has-text-align-right has-small-font-size wp-block-paragraph\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/blocks\/\">Go back to the list of Blocks<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Post Template block is a container block that is nested in the <a href=\"https:\/\/wordpress.org\/documentation\/article\/query-loop-block\/\" data-type=\"helphub_article\" data-id=\"14633622\">Query Loop<\/a> block. This block contains inner block elements used to display a post in the Query loop block such as the post title, post content or excerpt, date, and featured image.<\/p>\n\n\n\n<figure class=\"wp-block-video\"><video height=\"936\" style=\"aspect-ratio: 1484 \/ 936;\" width=\"1484\" controls src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Kapture-2026-04-10-at-12.47.19.mp4\"><\/video><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Add a Post Template block inside a Query Loop block<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">To find the Post Template<strong> <\/strong>block, click the <strong>Block Inserter<\/strong> icon, then search for the <strong>Query Loop<\/strong> block. Click on it to insert the block to the editor. Alternatively, you can type <kbd>\/query-loop<\/kbd> to quickly insert the Query Loop block. <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Click <strong>Choose<\/strong> to open a selection of patterns. Click on the pattern you would like to use to display your posts.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Block toolbar<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">When users select a block, the block toolbar containing a number of control buttons will appear above the selected block. The Post Template block toolbar includes the following tools:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Transform to<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"380\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-12.57.33-PM-1024x380.png\" alt=\"Post Template block toolbar transform options\" class=\"wp-image-16367332\" style=\"aspect-ratio:2.694769864222342;width:642px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-12.57.33-PM-1024x380.png 1024w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-12.57.33-PM-300x111.png 300w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-12.57.33-PM-768x285.png 768w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-12.57.33-PM.png 1346w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Users can transform the Post Template<em> <\/em>block into a <strong>Columns<\/strong> or a <strong>Group<\/strong> block.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Block-moving tools<\/h3>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"624\" height=\"122\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/block-toolbar-moving-Screenshot-2026-04-10-at-12.59.18-PM-copy.png\" alt=\"Post Template block toolbar moving options\" class=\"wp-image-16367333\" style=\"width:302px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/block-toolbar-moving-Screenshot-2026-04-10-at-12.59.18-PM-copy.png 624w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/block-toolbar-moving-Screenshot-2026-04-10-at-12.59.18-PM-copy-300x59.png 300w\" sizes=\"auto, (max-width: 624px) 100vw, 624px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Use the block-moving tools to move the Post Template block. The six dots icon allows you to freely reposition the block anywhere within the editor by dragging and dropping it. You can also use the arrows icon to move the block up or down the editor.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">List view button<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Display posts in a simple list. In list view, you will see a Layout toggle for Inner blocks use content width.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"421\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.16.06-PM-1024x421.png\" alt=\"Post Template block toolbar List view button\" class=\"wp-image-16367343\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.16.06-PM-1024x421.png 1024w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.16.06-PM-300x123.png 300w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.16.06-PM-768x316.png 768w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.16.06-PM-1536x631.png 1536w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.16.06-PM.png 2030w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Grid view button<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Display posts in a grid. You can choose how many columns to display items in in the Block Settings panel.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"998\" height=\"543\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.06.01-PM.png\" alt=\"Post Template block toolbar Grid view button\" class=\"wp-image-16367337\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.06.01-PM.png 998w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.06.01-PM-300x163.png 300w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.06.01-PM-768x418.png 768w\" sizes=\"auto, (max-width: 998px) 100vw, 998px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">More options<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The <a href=\"https:\/\/wordpress.org\/documentation\/article\/more-options\">More options menu<\/a> represented by <strong>three vertical dots<\/strong> on the far right of the toolbar gives you more features such as the ability to duplicate, remove, or edit your block as HTML.<\/p>\n\n\n\n<p class=\"has-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/more-options\/\">Read about the More options settings<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Block settings<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Every block has specific options in the editor sidebar in addition to the options found in the block toolbar.&nbsp;To access block settings, click the Settings button at the top-right corner of the editor.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"550\" height=\"126\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.14.05-PM.png\" alt=\"\" class=\"wp-image-16367342\" style=\"aspect-ratio:4.365198711063373;width:317px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.14.05-PM.png 550w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.14.05-PM-300x69.png 300w\" sizes=\"auto, (max-width: 550px) 100vw, 550px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Layout <\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Depending if you have chosen List view or Grid view from the block toolbar, you will see different layout options.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>List view: Inner blocks use content width toggle<\/li>\n\n\n\n<li>Grid view: Column number option<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"317\" height=\"1024\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.19.27-PM-317x1024.png\" alt=\"\" class=\"wp-image-16367344\" style=\"width:295px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.19.27-PM-317x1024.png 317w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.19.27-PM-93x300.png 93w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.19.27-PM-476x1536.png 476w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-04-10-at-1.19.27-PM.png 552w\" sizes=\"auto, (max-width: 317px) 100vw, 317px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Color <\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Post Template block provides color settings options to change the text and background colors.<\/p>\n\n\n\n<p class=\"has-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/colors-settings-overview\/\">See this guide for more information about changing colors<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Typography<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Post Template 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=\"has-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/typography-settings-overview\/\">Get more details about changing typography settings<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Dimensions <\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Post Template block provides dimension settings options.<\/p>\n\n\n\n<p class=\"has-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/dimension-controls-overview\/\">Learn more about dimension controls<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Border<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Verse block provides border settings options to add border color, width, and radius.<\/p>\n\n\n\n<p class=\"has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/border-settings-overview\/\">Learn more about border settings<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Advanced<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Post Template block provides the following Advanced settings options: HTML anchor, Additional CSS Class(es), Additional CSS, and Styles.<\/p>\n\n\n\n<p class=\"has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/advanced-settings-overview\/\">Learn more about advanced settings<\/a><\/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\">\n<h2 class=\"wp-block-heading has-medium-font-size\">Changelog<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Updated 2026-05-26 (props to @kjoyner @awetz583)\n<ul class=\"wp-block-list\">\n<li>Updated &#8220;Advanced&#8221; section to refer to new overview page<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Updated 2026-04-10 (props to @mosescursor @awetz583 @manuelaugustin @suascat)\n<ul class=\"wp-block-list\">\n<li>Updated screenshots and video<\/li>\n\n\n\n<li>Added List view and Grid view button information<\/li>\n\n\n\n<li>Updated Block settings list to include layout, color, dimensions and border<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Created 2022-11-23<\/li>\n<\/ul>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Go back to the list of Blocks The Post Template block is a container block that is nested in the Query Loop block. This block contains inner block elements used to display a post in the Query loop block such as the post title, post content or excerpt, date, and featured image. Add a Post [&hellip;]<\/p>\n","protected":false},"author":14322318,"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-16228384","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\/16228384","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\/14322318"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/comments?post=16228384"}],"version-history":[{"count":19,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16228384\/revisions"}],"predecessor-version":[{"id":16368618,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16228384\/revisions\/16368618"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/media?parent=16228384"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/category?post=16228384"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}