Title: Getting started with Blueprints
Published: July 15, 2026
Last modified: September 17, 2026

---

# Getting started with Blueprints

Also available in: [বাংলা](https://wordpress.github.io/wordpress-playground/bn/blueprints/getting-started/),
[日本語](https://wordpress.github.io/wordpress-playground/ja/blueprints/getting-started/),
[Português (BR)](https://wordpress.github.io/wordpress-playground/pt-br/blueprints/getting-started/),
[Tagalog](https://wordpress.github.io/wordpress-playground/tl/blueprints/getting-started/),
[ગુજરાતી](https://wordpress.github.io/wordpress-playground/gu/blueprints/getting-started/)

## In this article

 * [What problems are solved by Blueprints?](https://developer.wordpress.org/playground/blueprints/getting-started/?output_format=md#what-problems-are-solved-by-blueprints)
    - [No coding skills required](https://developer.wordpress.org/playground/blueprints/getting-started/?output_format=md#no-coding-skills-required)
    - [HTTP Requests are managed for you](https://developer.wordpress.org/playground/blueprints/getting-started/?output_format=md#http-requests-are-managed-for-you)
    - [You can link to a Blueprint-preconfigured Playground](https://developer.wordpress.org/playground/blueprints/getting-started/?output_format=md#you-can-link-to-a-blueprint-preconfigured-playground)
    - [Trusted by default](https://developer.wordpress.org/playground/blueprints/getting-started/?output_format=md#trusted-by-default)
    - [Write it once, use it anywhere](https://developer.wordpress.org/playground/blueprints/getting-started/?output_format=md#write-it-once-use-it-anywhere)

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

Blueprints are JSON files for setting up your very own WordPress Playground instance.
For example:

    ```language-json
    {
        "$schema": "https://playground.wordpress.net/blueprint-schema.json",
        "landingPage": "/wp-admin/",
        "preferredVersions": {
            "php": "8.3",
            "wp": "latest"
        },
        "steps": [
            {
                "step": "login",
                "username": "admin",
                "password": "password"
            }
        ]
    }
    ```

There are three ways to use Blueprints:

 * [Paste a Blueprint into the URL “fragment” on WordPress Playground website](https://developer.wordpress.org/playground/blueprints/using-blueprints#url-fragment).
 * [Use them with the JavaScript API](https://developer.wordpress.org/playground/blueprints/using-blueprints#javascript-api).
 * [Reference a blueprint JSON file via QueryParam blueprint-url](https://developer.wordpress.org/playground/developers/apis/query-api/)

## 󠀁[What problems are solved by Blueprints?](https://developer.wordpress.org/playground/blueprints/getting-started/?output_format=md#what-problems-are-solved-by-blueprints)󠁿

### 󠀁[No coding skills required](https://developer.wordpress.org/playground/blueprints/getting-started/?output_format=md#no-coding-skills-required)󠁿

Blueprints are just JSON. You don’t need a development environment, any libraries,
or even JavaScript knowledge. You can write them in any text editor.

However, if you do have a development environment, that’s great! You can use the
[Blueprint JSON schema](https://playground.wordpress.net/blueprint-schema.json) 
to get autocompletion and validation.

### 󠀁[HTTP Requests are managed for you](https://developer.wordpress.org/playground/blueprints/getting-started/?output_format=md#http-requests-are-managed-for-you)󠁿

Blueprints fetch any resources you declare for you. You don’t have to worry about
managing multiple `fetch()` calls or waiting for them to finish. You can just declare
a few links and let Blueprints handle and optimize the downloading pipeline.

### 󠀁[You can link to a Blueprint-preconfigured Playground](https://developer.wordpress.org/playground/blueprints/getting-started/?output_format=md#you-can-link-to-a-blueprint-preconfigured-playground)󠁿

Because Blueprints can be pasted in the URL, you can embed or link to a Playground
with a specific configuration. For example, clicking this button will open a Playground
with PHP 8.3 and a pendant theme installed:

[Try it out!](https://playground.wordpress.net/?mode=seamless#eyJwcmVmZXJyZWRWZXJzaW9ucyI6eyJwaHAiOiI4LjMiLCJ3cCI6ImxhdGVzdCJ9LCJzdGVwcyI6W3sic3RlcCI6Imluc3RhbGxUaGVtZSIsInRoZW1lRGF0YSI6eyJyZXNvdXJjZSI6IndvcmRwcmVzcy5vcmcvdGhlbWVzIiwic2x1ZyI6InBlbmRhbnQifSwib3B0aW9ucyI6eyJhY3RpdmF0ZSI6dHJ1ZX19XX0=)

### 󠀁[Trusted by default](https://developer.wordpress.org/playground/blueprints/getting-started/?output_format=md#trusted-by-default)󠁿

Blueprints are just JSON. Running other people’s Blueprints doesn’t require the 
element of trust. Since Blueprints cannot execute arbitrary JavaScript, they are
limited in what they can do.

With Blueprints, WordPress.org plugin directory may be able to offer live previews
of plugins. Plugin authors will just write a custom Blueprint to preconfigure the
Playground instance with any site options or starter content they may need.

### 󠀁[Write it once, use it anywhere](https://developer.wordpress.org/playground/blueprints/getting-started/?output_format=md#write-it-once-use-it-anywhere)󠁿

Blueprints work both on the web and in node.js. You can run them both in the same
JavaScript process, and through a remote Playground Client. They are the universal
language of configuration. Where you can run Playground, you can use Blueprints.

First published

July 15, 2026

Last updated

September 17, 2026

Edit article

[ Improve it on GitHub: Getting started with Blueprints ](https://raw.githubusercontent.com/WordPress/wordpress-playground/trunk/packages/docs/site/docs/blueprints/01-index.md)

Changelog

[ See list of changes: Getting started with Blueprints ](https://developer.wordpress.org/playground/blueprints/getting-started/?output_format=md#)

[  Previous: Blueprints Docs](https://developer.wordpress.org/playground/blueprints/)

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