Setup & site building · Guide
How to Use the WordPress Site Editor

Short answer
To use the WordPress Site Editor, activate a block theme, then go to Appearance, then Editor in your dashboard. From there you can change your site identity, styles, pages, navigation, patterns and templates with blocks. Save when you are done, and review the list of changed templates and parts before you confirm.
Key takeaways
- The Site Editor only works with a block theme, and it opens at Appearance, then Editor.
- Full site editing arrived with WordPress 5.9 on 25 January 2022, with Twenty Twenty-Two as the first default block theme.
- Styles change colors, typography and layout for the whole site at once.
- Pages have been editable inside the Site Editor since WordPress 6.3.
- Saving lists every changed template and part, so you can pick which ones to keep.
What is the WordPress Site Editor?
The Site Editor is the screen where you design your whole WordPress site with blocks, from the header and footer to templates and site-wide styles.
WordPress.org's Site Editor guide describes it as the tool that lets you design the entire site, including the header, footer and everything in between, with blocks. It gives you more control over how your site looks than the old theme settings screens did.
Full site editing arrived with WordPress 5.9 on 25 January 2022. The Make WordPress Core team introduced block themes in that release.
Twenty Twenty-Two shipped with it as the first default block theme. The Site Editor has grown with each release since then, and it is now the main way to shape a block theme.
If you already use the block editor for posts and pages, the Site Editor will feel familiar. It uses the same blocks and sidebar, but it edits your site structure instead of one post.
To see how the two editors fit together, read what full site editing is.
What do you need before you open the Site Editor?
You need an active block theme, because WordPress.org's Site Editor guide states the editor is only available with a block theme installed and active.
A block theme uses blocks for every part of a site, including navigation menus, the header, the content area and the site footer. Classic themes use PHP templates and the Customizer instead, so the Site Editor does not appear for them at all.
You can tell which kind of theme you have from the Appearance menu in your dashboard. A block theme shows an “Editor” item, while a classic theme shows “Customize” instead. If you see “Customize”, you need to switch themes before you can use the Site Editor.
To find a block theme, go to “Appearance”, then “Themes”, click “Add New”, and pick the “Block Themes” filter on the Add Themes page. WordPress.org's Site Editor guide lists exactly those steps. Learn the differences first in block theme vs classic theme.
How do you open the Site Editor?
Go to “Appearance”, then “Editor” in your WordPress dashboard to open the Site Editor.
Follow these steps:
- Log in to your WordPress dashboard with an account that can change the theme.
- Click “Appearance” in the left menu, then click “Editor”.
- Wait for the editor to load. It opens on your home page, based on what you set in Reading Settings.
- Use the sidebar to pick what you want to change: Identity, Styles, Pages, Navigation, Patterns or Templates.
- Click the back arrow in the top left to leave the current view and return to the previous screen.
WordPress 7.1 adds a persistent admin bar to every Site Editor screen, so you can reach WordPress and site navigation while you work. The bar hides when you turn on Distraction Free mode. If your Site Icon is set, it shows in the toolbar too.
What can you change in the Site Editor?
You can change your site identity, styles, pages, navigation, patterns and templates from the six menu items in the Site Editor sidebar.
| Menu item | What it controls |
|---|---|
| Identity | Site title, tagline, logo and site icon |
| Styles | Style variations, colors, typography and layout |
| Pages | Page content edited inside the Site Editor |
| Navigation | Menus and basic navigation changes |
| Patterns | Synced patterns and template parts |
| Templates | Layouts for page types such as single posts, archives and 404 pages |
The Identity panel sets the site title, tagline, logo and site icon at a high level, so it is a fast place to check your branding.
The Styles panel holds the style variations that ship with your theme, plus the color palettes, typography and layout settings that apply across the whole site.
The Pages section is newer than the rest. WordPress.org's Site Editor guide notes that managing, editing and creating pages inside the Site Editor has been possible since version 6.3. Before that, you had to leave the editor to work on page content.
Templates set the layout for a type of page, such as a single post, an archive or a search results page. Template parts are the repeating pieces, such as the header and footer, that appear on many pages at once.
How do you change your site colors and fonts?
Open Styles in the Site Editor to change your color palette, typography and layout for the whole site at once.
Start with a style variation if your theme ships one. A variation is a ready-made set of colors and fonts, and picking one changes the whole site in one click. You can then adjust single colors or font sizes from the same panel.
The Styles panel also lets you change how single blocks look across the whole site. For example, you can set the text color and size for every Heading block, or the background color for every Button block, without editing each page.
If a change does not suit you, open the three-dot menu in the top right and pick style revisions or reset. WordPress.org's Site Editor guide explains that menu in its Styles section. For sites that store styles as code, see how to use theme.json.
How do you edit a template or template part?
Open Templates or Patterns in the Site Editor, pick the template or template part, and edit its blocks like a page.
A template is a group of blocks that forms the layout for one kind of page. A template part is a block that holds a repeating global area, such as the header or footer.
Editing a template part changes it everywhere it appears, since it is reused across templates.
Follow these steps to edit your header:
- Go to “Appearance”, then “Editor”.
- Click “Patterns”, then “Template Parts”, then “Header”.
- Click the pencil icon to open the header for editing.
- Click a block to select it, and use List View at the top of the screen to pick nested blocks such as a Group or Row.
- Change the text, spacing or style in the block settings sidebar.
- Click “Save” and pick which template parts to save.
WordPress.org's Site Editor guide works through a similar example with the Twenty Twenty-Three theme, removing bottom padding from the header template part and top padding from the home template. The guide shows the header padding value changing from 2 to 0 and the home padding from 3 to 0.
How do you edit a page inside the Site Editor?
Open the Pages section in the Site Editor, pick a page, and edit its content without leaving the editor.
This works because WordPress 6.3 added page management to the Site Editor. You can browse your pages, open one, and edit its blocks in place, which keeps you in the same screen where you also control templates and styles.
The Command Palette speeds this up. WordPress.org's Site Editor guide says you can open it from the admin bar, or with “Cmd+K” on macOS and “Ctrl+K” on Windows and Linux. It lets you jump to content, templates and patterns, and it can run actions such as creating a page.
Use the Preview control in the top bar before you save, so you can see how the page looks on desktop, tablet and mobile. Patterns you use often are worth saving as reusable layouts, as explained in how to use block patterns.
How do you save and undo changes?
Click “Save” in the top bar, review the list of changed templates and parts, and save all of them or only some.
The save dialog lists every synced pattern, navigation menu, template and template part you changed. That list matters, because a change to a header or footer template applies to all pages that use that template, not just the page you were looking at.
The top bar also holds Undo and Redo buttons, so you can step back through your last actions one at a time. List View helps here too, since it shows every block on the page and lets you select exactly the block you need in a nested layout.
If you leave an editing view with unsaved changes, WordPress prompts you to save or review those changes before you go. Use the Back button in the upper left to return to the previous Site Editor screen when you are done.
How do you export your theme from the Site Editor?
Use Tools, then Export in the Site Editor to download a zip file of your theme with your edited templates and styles.
Follow these steps:
- Go to “Appearance”, then “Editor”.
- Click the three vertical dots next to the Styles option.
- Under “Tools”, select “Export”.
- Wait for the download. You receive a zip file of your theme with the templates and template parts included.
WordPress.org's Site Editor guide describes this export as a way to keep your theme with the changes you made in the Site Editor. It is a handy backup before a big redesign, and it lets you move your edited templates to another site that uses the same theme.
The Block Theme Overview in the WordPress developer handbook notes that you can export a theme directly from the Site Editor without touching any code.
The same Tools menu holds keyboard shortcuts, the Site Editor welcome guide, a copy-all-blocks option and links to support articles. Check the shortcuts once, since a few keys save a lot of clicking over time.
What mistakes should you avoid?
Avoid editing templates on a live site without a backup, and avoid changing a shared header or footer when you only meant to change one page.
Watch out for these common mistakes:
- Editing a template part and then wondering why every page changed. Template parts are shared, so check the save list before you confirm.
- Opening the Site Editor on a classic theme and finding no “Editor” menu. Switch to a block theme first, or use the Customizer for that theme.
- Changing colors on one page when you meant to change the whole site. Page-level block settings only affect that block, while Styles changes apply site-wide.
- Skipping the preview step. A header that looks fine on desktop can crowd a phone screen, so check each viewport before you save.
- Forgetting that styles can be reset. If a set of changes goes wrong, the three-dot menu offers style revisions and a full reset.
If you are new to block themes, start with small changes such as a style variation or a single color. Save often, review the save list each time, and export the theme once you are happy with the result.
Frequently asked questions
Can I use the Site Editor with a classic theme?
No. The Site Editor only appears with a block theme active. With a classic theme, the Appearance menu shows Customize instead of Editor, and you change the theme through the Customizer. Switch to a block theme if you want to use the Site Editor.
Where do I change my site colors in the Site Editor?
Open Styles in the Site Editor. Pick a style variation from your theme, or change the color palette, typography and layout by hand. Those settings apply to the whole site, and you can reset them from the three-dot menu if a change does not suit you.
Will editing a template change every page on my site?
Editing a template changes every page that uses it, and editing a template part such as the header changes it everywhere it appears. Check the save list before you confirm, and edit a single page in the Pages section when you only want one page to change.
How do I undo a change in the Site Editor?
Use the Undo button in the top bar to step back through your last actions, or open the three-dot menu to review style revisions and reset the changes completely. If you leave a view with unsaved changes, WordPress asks you to save or review them first.
Can I export my theme after editing it in the Site Editor?
Yes. Open the three-dot menu next to Styles, pick Tools, then Export, and WordPress downloads a zip file of your theme with your edited templates, template parts and style settings included.
Sources
- Site Editor WordPress.org
- Block themes, a new way to build themes in WordPress 5.9 Make WordPress Core
- Block Theme Overview WordPress Developer Resources
- WordPress Block Editor WordPress.org
- Block Patterns WordPress.org
- How to add and remove logo and site icon in Site Editor Learn WordPress
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


