Title: Blueprints Docs
Published: July 15, 2026
Last modified: July 16, 2026

---

# Blueprints Docs

[ Back to top](https://developer.wordpress.org/playground/blueprints/?output_format=md#wp--skip-link--target)

Check the [Blueprints Gallery](https://github.com/WordPress/blueprints/blob/trunk/GALLERY.md)
to explore real-world code examples of using WordPress Playground to launch a WordPress
site with a variety of setups.

Hi! Welcome to WordPress Playground Blueprints documentation.

Blueprints are JSON files for setting up your very own WordPress Playground instance.
This subsite (Blueprints Docs) is where you will find all the information you need
to use Blueprints.

The WordPress Playground documentation is distributed across four separate hubs (
subsites):

 * [**Documentation**](https://developer.wordpress.org/playground/) – Introduction
   to WP Playground, starter guides and your entry point to WP Playground Docs.
 * 👉 [**Blueprints**](https://developer.wordpress.org/playground/blueprints) (you’re
   here) – Blueprints are JSON files for setting up your WordPress Playground instance.
   Learn about their possibilities from this Blueprints docs hub.
 * [**Developers**](https://developer.wordpress.org/playground/developers) – WordPress
   Playground was created as a programmable tool. Discover all the things you can
   do with it from your code in the Developers docs hub.
 * [**API Reference**](https://developer.wordpress.org/playground/api) – All the
   APIs exposed by WordPress Playground

## Navigating the Blueprints documentation hub

This docs hub is focused on Blueprints info and is divided into the following major
sections:

 * [Getting started with Blueprints](https://developer.wordpress.org/playground/blueprints/getting-started):
   Quick Start Guide to setting up a WordPress Playground instance using Blueprint
   JSON files.
 * [Tutorial – Blueprints 101](https://developer.wordpress.org/playground/blueprints/tutorial)–
   Blueprints API crash course. The tutorial will guide you through the complete
   process of creating a blueprint that loads a theme and plugin (among other things).
 * [Blueprint data Format](https://developer.wordpress.org/playground/blueprints/data-format):
   Blueprint JSON files define your Playground instance with various properties.
   This section highlights the key properties you need to know.
 * [Using Blueprints](https://developer.wordpress.org/playground/blueprints/using-blueprints):
   Learn in this section different ways to use Blueprints.
 * [Steps](https://developer.wordpress.org/playground/blueprints/steps): API Reference
   of all the available steps that can be set in a blueprint to run tasks such as
   login, plugin/theme activation, file operations, and more.
 * [Blueprint Bundles](https://developer.wordpress.org/playground/blueprints/bundles):
   Learn how to create and use Blueprint bundles – self-contained packages that 
   include a Blueprint and all its resources.
 * [Examples](https://developer.wordpress.org/playground/blueprints/examples): Compilation
   of Blueprint examples for various WordPress Playground setups, including installing
   themes/plugins, running PHP code, enabling features, and loading specific WordPress
   versions.
 * [Troubleshoot and debug Blueprints](https://developer.wordpress.org/playground/blueprints/troubleshoot-and-debug):
   Tips and tools for troubleshooting and debugging Blueprints.

First published

July 15, 2026

Last updated

July 16, 2026

Edit article

[ Improve it on GitHub: Blueprints Docs ](https://raw.githubusercontent.com/WordPress/wordpress-playground/trunk/packages/docs/site/docs/blueprints/intro.md)

Changelog

[ See list of changes: Blueprints Docs ](https://developer.wordpress.org/playground/blueprints/?output_format=md#)

[  Previous: Changelog](https://developer.wordpress.org/playground/handbook/changelog/)

[  Next: Blueprints 101 – A crash course](https://developer.wordpress.org/playground/blueprints/tutorial/)