CC Child Pages Gutenberg Block Guide
Overview
Last updated: 8th November 2025 for CC Child Pages version 2.0
The CC Child Pages Gutenberg block provides a visual way to insert and configure child page listings in the block editor. It is a dynamic block that uses the same shortcode engine behind the scenes, giving you live previews and simplified settings.
In CC Child Pages Pro, additional skins, hover effects, and dynamic query filters are unlocked directly in the editor sidebar.
Adding the Block
- In the WordPress editor, click the + icon and search for CC Child Pages.
- Select the block to insert it into your page.
- Configure options from the right-hand Sidebar Panel.
- Save or preview your page to see the block in action.
Block Settings
| Setting | Description | Default | Equivalent Shortcode Attribute |
|---|---|---|---|
| Parent Page | Select which parent’s child pages to show. | Current page | id |
| Exclude Pages | Choose pages to exclude. | none | exclude |
| Order By | Sort results by title, menu order, or date. | menu_order | orderby |
| Order | Ascending or descending order. | ASC | order |
| Depth | Levels of hierarchy to include. | 1 | depth |
| Layout Columns | Number of columns in grid view. | 3 | cols |
| Show Thumbnails | Display featured image. | off | thumbs |
| Link Thumbnails | Make images clickable. | on | linkThumbs |
| Show Titles | Show or hide page titles. | on | showTitle |
| Show Excerpts | Show or hide page excerpts. | on | showExcerpt |
| Show “Read More” Link | Add a link at the end of each item. | on | showMore |
| Custom “Read More” Text | Text to display for the link. | Read More | more |
| Show Author | Display the author name. | off | showAuthor |
| Show Dates | Display created or modified date. | off | showDateCreated, showDateModified |
| Pagination | Split long lists into multiple pages. | off | usePagination |
| Posts per Page | Number of child pages per page. | 10 | postsPerPage |
| Use Legacy CSS | Enable compatibility mode for older themes. | off | useLegacyCSS |
Example Usage
Simple list of current page’s children:
Insert the block, leave Parent Page blank, and publish.Grid layout with thumbnails:
Set Layout Columns to 3, enable Show Thumbnails, and select Cards skin.Show siblings of the current page:
Toggle Show Siblings in sidebar (Pro feature).
Optional Reading
Choosing the Right Layout
Use columns to make navigation grids visually appealing. For text-heavy lists, choose one or two columns.
Legacy CSS Mode
Enable Legacy CSS if your theme predates block-based styling or uses older layout methods. This option improves compatibility with non-FSE themes.
Troubleshooting
- Block preview not updating: Try clicking outside the block and reselecting it.
- Broken layout on the front end: Check for CSS conflicts; switch to Legacy CSS if needed.
- Pagination not showing: Pagination appears only when there are more pages than the set limit.
Pro Version
In CC Child Pages Pro, you can also:
- Use hover effects and advanced skins like Masonry or Spotlight.
- Add taxonomy filters (tags, categories).
- Use dynamic queries to show related pages automatically.
- Integrate custom fields for excerpts and links.
FAQ
Q: Can I use multiple CC Child Pages blocks on one page?
A: Yes. Each block instance works independently.
Q: Can I convert an existing shortcode into a block?
A: Yes. Insert a Shortcode block and paste your shortcode, or replace it with the CC Child Pages block for a live preview.
Q: Is the block mobile responsive?
A: Yes. The layout adjusts automatically to fit different screen sizes.