Custom Query Blocks


A WordPress plugin for displaying posts and terms (e.g., categories) using a Gutenberg block. Works well with posts, pages, custom post types, taxonomies, and terms.

View Documentation and Overview

The plugin currently has three blocks:

Post Type Archive Mapping

This plugin also allows you to map your custom post type archive pages. Just create a page and go to Settings->Reading to set the page for your archive.

Ensure your post types have has_archive set to true.

You can also map term archives to pages by editing a term in the admin area.

  • Select a Public page to use as your post type archive page.
  • View the archive and you will see the page content instead of the archive content.
  • Use page templates on your pages for flexibility.
  • Custom Gutenberg block for showing your posts.

Term Archive Mapping

This plugin also allows you to map your term archives to a page. Just create a page and go to edit your term to set the archive page.

  • Create a public page to use as your term archive.
  • Visit the edit term page and select the page.
  • View the term and you will see your selected page.
  • Use Gutenberg on your public page to customize the archive.

404 Page Mapping

This plugin allows you to map a page to your 404 page, so you can customize as needed.


  • Setting up the custom post types block.
  • New Term Grid Block.
  • Settings->Reading option.
  • Term archive option.


이 플러그인은 3(을)를 제공합니다.

  • Custom Query Blocks
  • Featured Posts by Term
  • Custom Posts


  1. Just unzip and upload the “post-type-archive-mapping” folder to your ‘/wp-content/plugins/’ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress

Post Type Archive Mapping

  1. Create a custom post type that has an archive
  2. Create a page with a custom template. Use the Gutenberg block to show off posts in that Custom Post Type.
  3. Go to Settings->Reading and assign the page to the custom post type archive
  4. Go to the post type archive and observe the page content is now the archive

Term Archive Mapping

  1. Create a public page to use as your term archive.
  2. Visit the edit term page and select the page.
  3. View the term and you will see your selected page.
  4. Use Gutenberg on your public page to customize the archive.


I don’t see the post types. What’s wrong?

Make sure your post type has has_archive set to true and show_in_rest set to true.

Can you do posts instead of pages?

This plugin should work for any post type.

Does this plugin work with term (e.g., category) archives?

Yes. Edit a term and you can map it to any page.

I need help. Can you help me?

Yes, just post in the support forums here and I’ll do my best to address your issue. For priority support, you can visit my support form.


2021년 1월 15일
your ideas are great. Someday you will be very successful.
2020년 11월 13일
The plugin is good, but I have tried it with the Twenty Twenty theme, I went to create a post grid. It worked fine until I unabled the featured images. That broke the design, making the posts stack one after the other (breaking the grid).
2020년 8월 31일
This plugin is great and does exactly what I need it do and is simple to use. Thank you.
2020년 8월 16일
It is working! Yes! (custom post types generated with the Custom Post Types plugin, theme GP child, custom template is not working with my theme, but I am using Gutenberg blocks to design custom posts, and this plugin can show them on a page)
2020년 6월 30일
Finally, a block that pulls in any custom post type / taxonomy. Awesome job, does exactly what's needed.
모든 19 평가 읽기

기여자 & 개발자

“Custom Query Blocks”(은)는 오픈 소스 소프트웨어입니다. 다음의 사람들이 이 플러그인에 기여하였습니다.


“Custom Query Blocks”(이)가 4(으)로 번역되었습니다. 기여해 주셔서 번역자님께 감사드립니다.

자국어로 “Custom Query Blocks”(을)를 번역하세요.

개발에 관심이 있으십니까?

코드 탐색하기는, SVN 저장소를 확인하시거나, 개발 기록RSS로 구독하세요.



  • Released 2020-09-07
  • Added ability to map 404 to a page.
  • Fixed Gutenberg bugs in the Custom Post Types block and Featured Posts block.


  • Released 2020-08-23
  • Minimium supported version is now WordPress 5.5
  • Fixed pagination for WP 5.5.
  • Fixed REST API errors for WP 5.5.
  • Miscellaneous block fixes and updates.


  • Released 2020-05-17
  • Added Polylang support when mapping posts. Added WPML support for the main Custom Post Types block.


  • Released 2020-05-01
  • Removing the term redirect as some pages would get “stuck.”


  • Released 2020-04-29
  • Added pagination to the Featured Posts by Category Block.


  • Released 2020-04-20
  • Added featured posts by category block.
  • Added block previews.
  • New plugin name: Custom Query Blocks

= 4.0.5 –
* Released 2020-04-16
* Added compatibility for Yoast SEO.


  • Released 2020-04-12
  • New block: Term (Category) Grid Block.
  • HOT FIX: Term Grid wasn’t loading.


  • Released 2020-04-07
  • Updated plugin architecture.
  • Show mapped pages and its own column.
  • Mapped term pages now redirect to the correct term.
  • Added new contributor: Paal Joachim.


  • Released 2020-04-01
  • Fixing PHP notice saying invalid argument for foreach statement.


  • Released 2020-03-11
  • New full post mode for showing off the full post.
  • Option to remove the link from the title.


  • Released 2020-02-10
  • Plugin was having conflicts with other admin screens when saving terms, resulting in a 403 error.


  • Released 2020-02-03
  • Added support for translations.
  • Revised loading screen to make it easier on translators.


  • Released 2020-02-03
  • Added ability to map term archives to pages.


  • Released 2020-02-01
  • Added several order and orderby parameters.


  • Released 2020-01-26
  • Removing custom field placeholder if a custom field isn’t present.
  • Removing continue reading link and post link if custom post type isn’t publicly queryable.
  • Wrapping excerpt in paragraph tag.
  • Add class to readmore paragraph tag for styling.
  • Hiding styles options if override styles is present.
  • Changing verbiage of remove styles to Override styles.
  • Added support for Adobe fonts through


  • Released 2019-12-08
  • Added the ability to set a fallback image for the featured image.


  • Released 2019-12-05
  • Fixing pagination when a page with the Gutenberg block is set as the front page.


  • Released 2019-12-05
  • Moving featured image to its own panel in Gutenberg settings.
  • Moving title to its own panel in Gutenberg settings.
  • Cleaning up editor styles for headings.
  • Adding ability to change the heading HTML tag.


  • Released 2019-12-05
  • Adding ability to remove styles so that you can style your own layout.


  • Released 2019-12-03
  • Adding custom field support.
  • Updating REST API for faster loading.


  • Released 2019-12-02
  • Added ability to remove title from displaying.
  • Added new branded loading animation.


  • Released 2019-10-29
  • Testing up to WordPress 5.3.
  • Fixing JS error when jQuery is not defined as a $ variable.


  • Released 2019-08-23
  • Bug fix when in grid mode and image is placed below the title.
  • Bug fix: skipping taxonomies when there are none.
  • Bug fix: fixing capitalization error.
  • Enhancement: You can now select fonts for your content areas.


  • Released 2019-06-11
  • Fixing pagination


  • Released 2019-05-26
  • Some users were seeing featured images twice in the back-end.


  • Released 2019-05-25
  • Fixed Gravatar sizing not saving.
  • Changing the way excerpts are shown in Gutenberg.
  • Added the ability to change taxonomy location.
  • Content can now be centered in the Grid view.
  • Added border, padding, and background style options in Gutenberg block.
  • Added color options for text in Gutenberg block.


  • Released 2019-05-24
  • Added the ability to trim the excerpt length.
  • Reduce the file size of the Gutenberg block script using a new build technique.


  • Released 2019-04-21
  • Conditional term filtering


  • Released 2019-04-18
  • Adding support for six columns
  • Fixing undefined index error


  • Released 2019-03-29
  • Fixed term not being saved when displaying posts


  • Released 2019-01-17
  • Fixed pagination when using a page with just the block


  • Released 2019-01-17
  • Fixing bug where arguments weren’t an array when switching reading types in Settings->Reading.


  • Released 2019-01-06
  • Numerous enhancements to the Gutenberg block including showing taxonomies, setting the image type (Avatar vs Regular), setting where the featured image is displayed, selecting the image size, and much more.


  • Released 2018-11-07
  • WordPress 5.0 compatibility


  • Released 2018-09-24
  • Initial release.