Frequently asked questions about full site editing

On this FAQ page I will answer frequently asked questions about full site editing and the courses. You can also send me your own questions.

General questions about full site editing

When will full site editing be available in WordPress?

Full site editing is a name for several new features. The features will be added to WordPress in different phases.

New site blocks, new block settings, and the template editor was added to WordPress in 5.8.

Additional features like the site editor, global styles interface, and template parts, requires Gutenberg and may be included in WordPress 5.9.

What will happen to my existing website?

You will have access to new blocks and new features for some existing blocks, depending on what your theme supports.

If your theme has been updated with support for editing templates, than that feature is optional and you can use it, or choose not to use it.

What do I do if I want to use custom templates but my theme does not support it?

You have several options:
You can ask the people who created your theme to add it, you can change your theme,
or, you can enable custom templates by installing my plugin:
https://wordpress.org/plugins/enable-template-editor/
It is a very small plugin, but with it, you do not need to edit the code in the theme.

How do I enable the site editor?

From Gutenberg version 9.3.0, you no longer need to enable full site editing or the site editor manually.
The site editor is still experimental, but when you activate a full site editing theme, the features are automatically enabled.

On activation, you will see this notice in the WordPress admin area:
Full site editing activation notice.

What version of Gutenberg do I need to install to test full site editing?

As Gutenberg is updated every two weeks, I recommend that you use the latest release.

How do I know if a theme has support for full site editing?

A theme that has support for full site editing will have a folder called block-templates.

Where can I find a theme to test with full site editing?

Please visit this page where I have a list of themes that you can use.

Technical questions

How do I add custom post templates to a full site editing theme?

With HTML files:
Select your blocks and create an HTML file that you place inside the block-templates folder.
In the theme.json file, at the root level, add a new section called customTemplates:

      “customTemplates”: [
        {
            “name”: “about”,
            “title”: “about”
        }
    ]

The first value is the file name (slug) that you selected for the template,
and the title is the visible name in the editor.

You can find more information in the official documentation.

How do I add new custom templates to my website?

Custom templates are available for block themes and for classic themes that has support for the new feature that is added in WordPress 5.8.

You add custom templates to your website with the template editor:
Create a new post or page in the block editor.
Locate the Template section of the post settings sidebar.
There, you will see a select list with the available templates.
Click the “New” link to create a new template:


You will be asked to select a name for the template, and you will be redirected to the template editor.
Once in the template editor, you can edit the full page and add page header, footer, etc.
Remember to save the changes.

How do I use conditionals in a full site editing theme?

Instead of PHP if… else statements, you can use block settings and CSS.

The theme can still have different body classes depending on which page you are viewing, so you can use CSS to show or hide elements.

If the block settings are not enough to achieve what you need, you can extend existing blocks by adding new settings, but consider if this is something that should be in a theme or a plugin. This depends on what you are using the theme for.

If you have a really good example of when you would need to use a conditional, and you can’t achieve the same results using the available options, I encourage you to bring it up for discussion on the Gutenberg GitHub repository.

How do I use custom hooks in a full site editing theme?

If you need to use custom action hooks- I will assume that this is what most people are wondering about; you will need a custom block. 

I don’t have enough experience with creating custom blocks to be able to guide you, but you would likely be using the wp.hooks package with addAction and doAction.

Reference:  https://developer.wordpress.org/block-editor/packages/packages-hooks/

How do I use WordPress hooks in a full site editing theme?

Some actions and filters will work the same way for both classic and FSE themes, but not all, and there are bugs. 
You will be able to use actions like wp_body_open and wp_footer like before.

Many blocks use PHP for the front, and for some blocks, the PHP filter only affects the front. One known bug is that if you want to change the default excerpt length, you need to use both the PHP excerpt_length filter and update the WordCount block attribute.

I encourage you to help test existing filters so that bugs like these can be found and solved.

How do I use custom menu walkers in full site editing themes?

I have not done any testing with menu walkers but I expect some individual filters to work. I suggest reading through the source code for the navigation block first.

You will be able to add blocks as menu items to the navigation block, and this may reduce the need for menu walkers.

How do I use custom comment walkers in a full site editing theme?

It is currently possible to use custom comment walkers, but this seems to be a bug.
And if you add a comments.php file to your theme, it will be used to render the comments.

The good news is that you won’t need to because you will be able to use individual blocks to arrange your comments and the comments form.

Questions about the course

Do I need to know React to follow the developer course?

No, this is not a JavaScript-heavy course.

Will you teach me how to build custom blocks?

No, but there are lessons about custom block styles, variations, and block patterns.

Are the videos captioned?

The videos are captioned and full transcripts including the code examples are available on each lesson page.

Do you have a question about full site editing?

Send me your questions and I will try my best to answer them or do some testing. If I don’t know the answer, I can pass the question on and publish it here.

-If you find a question on this page that has no answer yet, please feel free to contribute.