Create Block Theme

Welcome to Create Block Theme - a WordPress plugin to create block themes from within the Editor.

It works alongside features that are already available in the Editor to enhance the workflow for creating block themes. After being tested in this plugin, some of the features included here may be moved into the Editor itself.

Disclaimer: Create Block Theme enables development features and thus is a tool that should be treated like as such; you can think of it as a Development Mode for WordPress, and you should keep in mind that changes made through this plugin could change your site and/or theme permanently.

This plugin allows you to:

• Export your existing theme with all customizations made in the Editor
• Create a new theme, blank theme, child theme, or style variation from the Editor

This plugin also makes several changes to the contents of an exported theme, including:

• Adds all images used in templates to the theme's assets folder.
• Ensures the block markup used in templates and patterns is export-ready.
• Ensures most strings used in templates and patterns are translate-ready.

Learn more about Create Block Theme:

• How to use the plugin
• How to contribute
• User FAQs

User Support

If you have run into an issue, you should check the Support Forums first. The forums are a great place to get help. If you have a bug to report, please submit it to this repository as an issue. Please search prior to creating a new bug to confirm its not a duplicate.

Plugin Features

Theme Creation Options

There are six options the plugin provides to create a new theme:

1. Export

Export the activated theme including the user's changes.

2. Create a child theme

Creates a new child theme with the currently active theme as a parent.

3. Clone the active theme

Creates a new theme by cloning the activated theme. The resulting theme will have all of the assets of the activated theme combined with the user's changes.

4. Overwrite theme files

Saves the user's changes to the theme files and deletes the user's changes from the site.

5. Generate blank theme

Generate a boilerplate "empty" theme inside of the current site's themes directory.

6. Create a style variation

Saves user's changes as a style variation of the currently active theme.

Embed Fonts

Save fonts in your theme that have been installed with the Font Library (found in WordPress 6.5+, more information).

How to Use the Plugin

Step 1: Setup

To use the latest release of the Create Block Theme plugin on your WordPress site: install from the plugins page in wp-admin, or download from the WordPress.org plugins repository.

There will be a new panel accessible from the WordPress Editor, which you can open by clicking on a new icon to the right of the "Save" button, at the top of the Editor.

In the WordPress Admin Dashboard, under Appearance there will also be a new page called "Create Block Theme".

Step 2: Styles and templates customizations

Make changes to your site styles, fonts and templates using the Editor.

Step 3: Save

Still in the WordPress Editor, navigate to the Create Block Theme menu at the top of the Editor.

To simply save recent changes made in the Editor to the currently active theme or export the theme:

• Select "Save Changes" to save any recent changes to the currently active theme.
• Select "Export Zip" to export the theme as a zip file.

To edit the theme metadata:

• Select "Theme Info" to edit the metadata for the theme. These details will be used in the style.css file.

To create a new theme, child theme, or style variation, select "Create Theme" to access the following options for the currently active theme:

• "Clone Theme" to create a copy of the active theme.
• "Create Child Theme" to create a child theme of the active theme.
• "Create Theme Variation" to create a style variation.
• "Export Theme" to export the theme as a zip file.
• "Export Child Theme" to export a child of the currently active theme as a zip file.
• "Create Blank Theme" to create a new, blank theme with no styles or templates.

To inspect the active theme's theme.json contents:

• Select "Inspect Theme JSON"

Many of these options are also available under the older, deprecated Create Block Theme page under Appearance > Create Block Theme.

To install and uninstall fonts:

• Install and activate a font from any source using the WordPress Font Library.
• Select "Save Changes" to save all of the active fonts to the currently active theme. These fonts will then be activated in the theme and deactivated in the system (and may be safely deleted from the system).
• Any fonts that are installed in the theme that have been deactivated with the WordPress Font Library will be removed from the theme.

How to Contribute

We welcome contributions in all forms, including code, design, documentation, and triage. Please see our Contributing Guidelines for more information.