Warning
You're browsing the documentation for an old version of Webiny. Consider upgrading your project to Webiny 5.39.x.
What You’ll Learn
  • how to create page layouts
  • how to assign page layouts to pages created with Page Builder

Overview
anchor

All pages created with Page Builder’s page editor are rendered within a page layout.

For example, the Static page layout, that’s by default included in every Webiny project, renders pages in a relatively standard headercontentfooter structure.

Static Page LayoutStatic Page Layout
(click to enlarge)

React Components and Plugins
anchor

On the code level, page layouts consist of one or more React components. For example, if we were to take a look at the Static.tsxexternal link file, located in the apps/theme/layouts/pagesexternal link folder, we would see the following code:

apps/theme/layouts/pages/Static.tsx

Essentially, the file exports a page layout React component, which renders the following:

  1. the actual page layout (notice extra components like Layout and Header)
  2. the page content created via Page Builder’s page editor (passed via the children prop)

Depending on the requirements, page layouts can be simple or more complex. For example, the Static.tsxexternal link file also contains Header and Footer components, which are used to render the header and footer of the page layout.

Ultimately, all page layouts are registered via the PbPageLayoutPluginexternal link, plugin, which can be done within the apps/theme/index.tsexternal link entrypoint file:

apps/theme/index.ts

The plugin is what actually makes the page layout visible in the Page Builder application and, ultimately, enables users to assign the layout to one or more pages and have their content rendered within it.

More on this in the following section.

Assigning Page Layouts to Pages
anchor

Page layouts can be assigned to pages in two ways.

1. Page Categories
anchor

The first is by selecting a default page layout for a page category. For example, if we were to create a new Blogs category, and we selected the Static page layout in the Layout field, all pages created in the Blogs category would be rendered using the Static page layout.

Theme ColorsTheme Colors
(click to enlarge)

Note that the layout can be changed at any time, and the change will be reflected on all existing pages that use the layout. Additionally, the layout can be changed for individual pages, which will override the default layout set via the category. This is covered in the next section.

2. Page Settings
anchor

Page layout can also be selected via page settings in the page editor. This enables us to override the default layout set via the category.

This is achieved by selecting the desired layout in the Layout field, located in the General Settings tab in the page settings area.

Selecting Page Layout via Page SettingsSelecting Page Layout via Page Settings
(click to enlarge)

Page settings can be accessed by clicking on the cogwheel icon, located in the top right corner of the page editor.

Accessing Page Settings in the Page EditorAccessing Page Settings in the Page Editor
(click to enlarge)

Introducing New Page Layouts
anchor

If required, users can introduce additional page layouts into their project and use them with different pages. For example, let’s imagine we wanted to introduce a completely blank layout, that doesn’t render any header or footer.

Like with the Static page layout, we would need to create a new page layout React component, and register it via the PbPageLayoutPluginexternal link plugin.

For the component, the following would be all the code that’s required:

apps/theme/layouts/pages/Blank.tsx

And for the registration, we would need to add the following to the apps/theme/index.tsexternal link file:

apps/theme/index.ts

With the above code in place, we should be able to create pages and select the Blank page layout to be used.

Styling Page Layouts
anchor

As mentioned in the Introduction section, Webiny relies on Emotion for all of the styling needs. This includes styling of page layouts.

If we were to take another look at the apps/theme/layouts/pages/Static.tsxexternal link file, we could notice the Emotion’s Globalexternal link component being used to inject global styles into the page. We could also notice the usage of the @emotion/styledexternal link package, which enables us to create styled components. In this case, the Layout component.

apps/theme/layouts/pages/Static.tsx

The Header and Footer components that are being included in the layout are also styled using Emotion.