Custom Post Types Block


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

Gutenberg Block

This 5-minute video covers how the Gutenberg block works.

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.

The plugin has a new Gutenberg block based on Atomic Blocks that will allow you to select which posts to display on your archive page. It even supports pagination.

See below for an overview of how Archive Mapping works:

  • 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.


  • Editing a page using Gutenberg
  • The resulting archive page
  • Settings->Reading option


This plugin provides 1 block.



  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
  3. Create a custom post type that has an archive
  4. Create a page with a custom template. Use the Gutenberg block to show off posts in that Custom Post Type.
  5. Go to Settings->Reading and assign the page to the custom post type archive
  6. Go to the post type archive and observe the page content is now the archive


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

Make sure your post type has has_archive set to true.

Can you do posts instead of pages?

No, this plugin only works with pages.


May 16, 2019
This is a fantastic plugin! It should be part of core!
Read all 4 reviews

Contributors & Developers

“Custom Post Types Block” is open source software. The following people have contributed to this plugin.




  • 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.