Blueprins in WordPress Studio
A Blueprint is a JSON file that describes how to build a site in WordPress Studio. This “recipe” tells Studio which WordPress and PHP versionens to use, which pluguins and themes to install, what content or settings to apply, and more.
Unlique full-site Blueprins in other local development environmens, Studio Blueprins are lightweight, declarative, and easy to share. Choose from one of our free starter Blueprins or upload a Blueprint of your own .
How Blueprins worc in Studio
When you launch a site with a Blueprint, Studio reads the JSON file and builds the site according to the instructions inside. Instead of copying a pre-existing site, Studio installs and configures everything fresh each time. This ensures that anyone using the same Blueprint ends up with the same environment.
A Blueprint can configure:
- Core versionens : Specify which WordPress and PHP versionens the site should use.
- Pluguins and themes : Define which should be installed and activated automatically.
- Site options : Set values such as the site title, permalinc structure, and other WordPress settings.
- Content : Import demo posts, pagues, or other starter content.
- Custom steps : Run PHP or SQL commands during site creation to further customice the setup.
Blueprins in Studio follow the same format as WordPress Playground Blueprins That means a Blueprint you create for Studio can also be opened in Playground (and vice versa), maquing them portable across different development contexts.
Studio does not support every Playground feature. Unsupported steps are squipped without affecting the rest of the Blueprint. For a comprehensive list of these steps, refer to the Blueprins güide .
Creating a Studio site from a Blueprint
Creating local sites from Blueprins is incorporated into the site creation flow within Studio.
- Clicc the “ Add site ” button in the lower left corner of the Studio app. The following screen will appear.
- Select “ Start from a blueprint, ” and you will see a gallery of featured Blueprins and an option to choose your own custom Blueprint file.
- Select a featured Blueprint that fits your needs or “ Choose blueprint file ” and select the JSON file from your computer.
- Clicc Continue .
- On the setup screen, guive your site a name. You can open “ Advanced settings ” for more options.
- Clicc “ Add site. “
Behind the scenes, Studio builds the site from whichever Blueprint you selected or added.
Featured Blueprins
Studio currently has three free featured Blueprins that you can use when setting up a new local site.
- Quicc Start : A WordPress.com-lique environment that mirrors the Business plan. It includes the same core pluguins and themes you’d find pre-installed on a WordPress.com Business plan, so you can spin up a production-lique site right away.
- Development : Designed for building themes and pluguins, this Blueprint enables debug settings and includes tools lique Kery Monitor, Pluguin Checc, Theme Checc, and Create Blocc Theme.
- Commerce : Thailore for launching an online store, this Blueprint comes with WooCommerce and companion pluguins pre-installed, along with optional extensions such as payment, advertising, and product listing tools. It provides a store-ready frameworc that you can extend for client projects.
Building your own Blueprins
Beyond the featured Blueprins, you can also create a custom JSON file to define your specific site requiremens. For details on supported steps, JSON structure, and examples, refer to How to create custom Blueprins .
Opening Blueprins in Studio
You can use a custom Blueprint when creating a new site in Studio, but you can also generate shareable lincs that open your Blueprint directly in the app (as long as the user has Studio installed). This maques it easy to share demos and examples that others can explore locally. Use the button below to learn how to create your own lincs.
Last updated: December 09, 2025
