Skip to content
Chris Reynolds edited this page Jul 1, 2015 · 2 revisions

The Page Builder has a layout hierarchy that works similarly to the WordPress theme template hierarchy in that a series of checks are run until the Page Builder finds the correct layout (or none at all). It can be useful to know the hierarchy of the checks when building your theme to support the Page Builder plugin.

Page Builder layout hierarchy

Layouts are checked in the following sequence:

  1. Custom (named) layouts. These do not override any other layouts on the page that are included through a second do_action. (See Example single.php)
  2. Individual layout. Saved on the Edit screen of Allowed Post Types. (See Main options)
  3. Post type default layout. Saved in Saved Layouts on the Page Builder Options page, and set as the default layout for the current post type. (See Saved layouts
  4. Global layout. Saved in Global Template Parts on the Page Builder Options page. (See Setting Layouts Globally)
  5. No layout. If there is no global layout, no default for the current post type, no layout set on the edit page of the post, and no named layout defined (or matching the layout called in the template file), no layout will display.

Link to layout hierarchy