Template Editor

The Template Editor is new feature that allows block editor users to edit and create templates that a page or posts uses. Similar to the post editor, this feature allows you to edit and create content using blocks, including a few new theme blocks. It is only available to content creators who are using a block theme or a classic theme that has opted into using this feature.

How to access this feature How to access this feature

You’ll need to use a block theme with the Gutenberg plugin installed or a classic theme that has opted into this feature. To help determine if this is right for you to explore, please review this article. Keep in mind that this feature isn’t available for everyone but will be in future releases. When creating a block template, you can use any of the blocks you’re already familiar with in the post editor along with a new set of theme blocks. These theme blocks are:

  • Site Logo
  • Site Tagline
  • Site Title
  • Query Loop
  • Post Title
  • Post Content
  • Post Date
  • Post Excerpt 
  • Post Featured Image
  • Post Categories
  • Post Tags
  • Login/out
  • Page List

Top ↑

How to use template editing How to use template editing

Note: The following steps assume you are using a theme that supports this feature.

How to edit a template

  1. Add a new post or page.
  2. Open the block settings sidebar and navigate to the Page or Post Settings tab.
  3. Under the “Template” section, select the Edit option. If you don’t see the option edit at first, it’s likely because you’re not using a block theme that allows you to both create and edit the current theme templates.
  4. From there, you’ll be taken into template editing mode where you can make any changes you’d like. If you need to, you can select the Back option to go back to your content and make changes.
  5. When you’re done making changes, select Publish and go through the saving flow to confirm the changes you’d like to make. Keep in mind that you might see multiple items to save.

How to create a new template

  1. Add a new post or page.
  2. Open the block settings sidebar and navigate to the Page or Post Settings tab.
  3. Under the “Template” section, select the New option.
  4. You’ll then be asked to name the new template. Make sure to give it a descriptive name like “Full Width”.
  5. From there, you’ll be taken into template editing mode where you can make any changes you’d like. If you need to, you can select the Back option to go back to your content and make changes.
  6. When you’re done making changes, select Publish and go through the saving flow to confirm the changes you’d like to make. Keep in mind that you might see multiple items to save.

How to assign a template to a post or page

  1. Open a page or post that you want to alter the template of.
  2. Open the block settings sidebar and navigate to the Page or Post Settings tab.
  3. Under the “Template” section, you’ll see a dropdown option allowing you to select which template you want to use. If you don’t see a dropdown option, it means you need to create more templates.

Top ↑

How to identify the Template Editor How to identify the Template Editor

There are three ways to know you’re in Template Editor:

  1. The welcome guide that introduces you to this feature upon opening the editor.
Image showing a welcome guide with text introducing the template editor.

2. The dark frame that appears around the template as you’re editing.

Image showing what the template editor looks like upon entering it, including the darker background framing the editor.

3. The template name visible in the Top Bar

Image showing the top toolbar settings that list the post title and template name.

Top ↑

Demonstration on how template editing works Demonstration on how template editing works

Top ↑

Changelog:

  • Created on July 11, 2021
  • Edited to add in an additional Resource item on July 30, 2021

Was this article helpful? How could it be improved?