Title: Post Template block
Author: Femy Praseeth
Published: November 23, 2022
Last modified: May 27, 2026

---

# Post Template block

## In this article

 * [Add a Post Template block inside a Query Loop block](https://wordpress.org/documentation/article/post-template-block/?output_format=md#add-a-post-template-block-inside-a-query-loop-block)
 * [Block toolbar](https://wordpress.org/documentation/article/post-template-block/?output_format=md#block-toolbar)
    - [Transform to](https://wordpress.org/documentation/article/post-template-block/?output_format=md#transform-to)
    - [Block-moving tools](https://wordpress.org/documentation/article/post-template-block/?output_format=md#block-moving-tools)
    - [List view button](https://wordpress.org/documentation/article/post-template-block/?output_format=md#list-view-button)
    - [Grid view button](https://wordpress.org/documentation/article/post-template-block/?output_format=md#grid-view-button)
    - [More options](https://wordpress.org/documentation/article/post-template-block/?output_format=md#more-options)
 * [Block settings](https://wordpress.org/documentation/article/post-template-block/?output_format=md#block-settings)
    - [Layout](https://wordpress.org/documentation/article/post-template-block/?output_format=md#layout)
    - [Color](https://wordpress.org/documentation/article/post-template-block/?output_format=md#color)
    - [Typography](https://wordpress.org/documentation/article/post-template-block/?output_format=md#typography)
    - [Dimensions](https://wordpress.org/documentation/article/post-template-block/?output_format=md#dimensions)
    - [Border](https://wordpress.org/documentation/article/post-template-block/?output_format=md#border)
    - [Advanced](https://wordpress.org/documentation/article/post-template-block/?output_format=md#advanced)
 * [Changelog](https://wordpress.org/documentation/article/post-template-block/?output_format=md#changelog)

[ Back to top](https://wordpress.org/documentation/article/post-template-block/?output_format=md#wp--skip-link--target)

[Go back to the list of Blocks](https://wordpress.org/documentation/article/blocks/)

The Post Template block is a container block that is nested in the [Query Loop](https://wordpress.org/documentation/article/query-loop-block/)
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 Template block inside a Query Loop block](https://wordpress.org/documentation/article/post-template-block/?output_format=md#add-a-post-template-block-inside-a-query-loop-block)󠁿

To find the Post Template** **block, click the **Block Inserter** icon, then search
for the **Query Loop** block. Click on it to insert the block to the editor. Alternatively,
you can type /query-loop to quickly insert the Query Loop block.

Click **Choose** to open a selection of patterns. Click on the pattern you would
like to use to display your posts.

## 󠀁[Block toolbar](https://wordpress.org/documentation/article/post-template-block/?output_format=md#block-toolbar)󠁿

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:

### 󠀁[Transform to](https://wordpress.org/documentation/article/post-template-block/?output_format=md#transform-to)󠁿

![Post Template block toolbar transform options](https://wordpress.org/documentation/
files/2022/11/Screenshot-2026-04-10-at-12.57.33-PM-1024x380.png)

Users can transform the Post Template_ _block into a **Columns** or a **Group** 
block.

### 󠀁[Block-moving tools](https://wordpress.org/documentation/article/post-template-block/?output_format=md#block-moving-tools)󠁿

![Post Template block toolbar moving options](https://wordpress.org/documentation/
files/2022/11/block-toolbar-moving-Screenshot-2026-04-10-at-12.59.18-PM-copy.png)

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.

### 󠀁[List view button](https://wordpress.org/documentation/article/post-template-block/?output_format=md#list-view-button)󠁿

Display posts in a simple list. In list view, you will see a Layout toggle for Inner
blocks use content width.

![Post Template block toolbar List view button](https://wordpress.org/documentation/
files/2022/11/Screenshot-2026-04-10-at-1.16.06-PM-1024x421.png)

### 󠀁[Grid view button](https://wordpress.org/documentation/article/post-template-block/?output_format=md#grid-view-button)󠁿

Display posts in a grid. You can choose how many columns to display items in in 
the Block Settings panel.

![Post Template block toolbar Grid view button](https://wordpress.org/documentation/
files/2022/11/Screenshot-2026-04-10-at-1.06.01-PM.png)

### 󠀁[More options](https://wordpress.org/documentation/article/post-template-block/?output_format=md#more-options)󠁿

The [More options menu](https://wordpress.org/documentation/article/more-options)
represented by **three vertical dots** on the far right of the toolbar gives you
more features such as the ability to duplicate, remove, or edit your block as HTML.

[Read about the More options settings](https://wordpress.org/documentation/article/more-options/).

## 󠀁[Block settings](https://wordpress.org/documentation/article/post-template-block/?output_format=md#block-settings)󠁿

Every block has specific options in the editor sidebar in addition to the options
found in the block toolbar. To access block settings, click the Settings button 
at the top-right corner of the editor.

![](https://wordpress.org/documentation/files/2022/11/Screenshot-2026-04-10-at-1.14.05-
PM.png)

### 󠀁[Layout](https://wordpress.org/documentation/article/post-template-block/?output_format=md#layout)󠁿

Depending if you have chosen List view or Grid view from the block toolbar, you 
will see different layout options.

 * List view: Inner blocks use content width toggle
 * Grid view: Column number option

![](https://wordpress.org/documentation/files/2022/11/Screenshot-2026-04-10-at-1.19.27-
PM-317x1024.png)

### 󠀁[Color](https://wordpress.org/documentation/article/post-template-block/?output_format=md#color)󠁿

The Post Template block provides color settings options to change the text and background
colors.

[See this guide for more information about changing colors](https://wordpress.org/documentation/article/colors-settings-overview/)

### 󠀁[Typography](https://wordpress.org/documentation/article/post-template-block/?output_format=md#typography)󠁿

The Post Template block provides typography settings to change the font family, 
appearance, line height, letter spacing, decoration, letter case, and font size.

[Get more details about changing typography settings](https://wordpress.org/documentation/article/typography-settings-overview/)

### 󠀁[Dimensions](https://wordpress.org/documentation/article/post-template-block/?output_format=md#dimensions)󠁿

The Post Template block provides dimension settings options.

[Learn more about dimension controls](https://wordpress.org/documentation/article/dimension-controls-overview/)

### 󠀁[Border](https://wordpress.org/documentation/article/post-template-block/?output_format=md#border)󠁿

The Verse block provides border settings options to add border color, width, and
radius.

[Learn more about border settings](https://wordpress.org/documentation/article/border-settings-overview/)

### 󠀁[Advanced](https://wordpress.org/documentation/article/post-template-block/?output_format=md#advanced)󠁿

The Post Template block provides the following Advanced settings options: HTML anchor,
Additional CSS Class(es), Additional CSS, and Styles.

[Learn more about advanced settings](https://wordpress.org/documentation/article/advanced-settings-overview/)

## 󠀁[Changelog](https://wordpress.org/documentation/article/post-template-block/?output_format=md#changelog)󠁿

 * Updated 2026-05-26 (props to @kjoyner @awetz583)
    - Updated “Advanced” section to refer to new overview page
 * Updated 2026-04-10 (props to @mosescursor @awetz583 @manuelaugustin @suascat)
    - Updated screenshots and video
    - Added List view and Grid view button information
    - Updated Block settings list to include layout, color, dimensions and border
 * Created 2022-11-23

## Was this article helpful? How could it be improved? 󠀁[Cancel reply](https://wordpress.org/documentation/article/post-template-block/?output_format=md#respond)󠁿

[Log in to submit feedback](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fwordpress.org%2Fdocumentation%2Farticle%2Fpost-template-block%2F&locale=en_US).
If you need support with something that wasn't covered by this article, please post
your question in the [support forums](https://wordpress.org/support/forums/).

First published

November 23, 2022

Last updated

May 27, 2026