The Comment Pagination block displays paginated navigation to the next or previous set of comments. This is a part of the Comments Query Loop block that lets you customize the layout and appearance of the navigation.
You can only insert the Comment Pagination block inside a Comment Query Loop block.
A Comment Pagination block is already included by default when you add a Comments Query Loop block. That said, you can insert it manually when needed.
Click the (+) icon inside the Comments Query Loop block to open the block inserter pop-up window and search for the Comment Pagination block.
You can also use the keyboard shortcut /comment-pagination to insert a Comment Pagination block quickly.
Detailed instructions on adding blocks
Block toolbar
The block toolbar contains tools to customize each block on the editor quickly. The Comment Pagination block has the following tools:
Transform to
You can transform a Comment Pagination block into a Columns, or a Group block.

Block-moving tools
The block-moving tools allow you to move the block up and down the editor. Use the six dots icon to drag and drop the Comment Pagination block and place it anywhere on the Comments Query Loop block. Alternatively, click on the up and down arrows to move the block up or down.
Get more information about moving a block within the editor.
Change items justification
The change items justification tool lets you change the horizontal placement of the items inside the Comment Pagination block. There are four options to choose from:
- Justify items left will move the items towards the left side of the block.
- Justify items center will move the items towards the center of the block.
- Justify items right will move the items towards the right side of the block.
- Space between items will distribute all items across the block and automatically adjust the space between them.
Change vertical alignment
The change vertical alignment tool lets you choose the vertical position of the items inside the Comment Pagination block. You can choose between top, middle, and bottom vertical alignment.
Change alignment
Unlike the previous alignment tools, the change alignment tool is used for the Comment Pagination block’s position inside the Comments Query Loop block. Choose one of the following block alignment options:
- None
- Align left
- Align center
- Align right
More options
These controls give you the option to copy, duplicate, and edit your block as HTML.
Read about these and other settings.
Block settings
The block settings panel contains customization options specific to the block. To open it, select the block and click the cog icon next to the Publish button.
Here are the options for the Comment Pagination block:
Layout
In the layout section, you will find the following customization options:
- Justification settings are similar to the tools in the block toolbar.
- Orientation lets you choose to display the pagination items horizontally or vertically.
- Allow to wrap to multiple lines toggle button lets you display the pagination items in multiple lines when needed.
Settings
The settings section shows three options for a decorative arrow to the next and previous comments link. Here are the options:
- None
- Arrow
- Chevron
Color
The color section lets you customize the text, background, and link color for the Comment Pagination block. Click on any of the options to change the color, and a pop-up to pick a color will appear. Choose from the default color or click the upper rectangle area to pick a custom color using the color picker.
Read about these and other settings.
Advanced
The “Advanced” tab lets you add CSS class(es) to your block. This will allow you to write custom CSS and styles to the block.
Changelog
- Created 2022-08-02
Was this article helpful? How could it be improved?
Log in to submit feedback. If you need support with something that wasn't covered by this article, please post your question in the support forums.