Title: Blueprints JSON and the API Client
Published: July 15, 2026
Last modified: July 16, 2026

---

# Blueprints JSON and the API Client

[ Back to top](https://developer.wordpress.org/playground/developers/apis/javascript-api/blueprint-json/?output_format=md#wp--skip-link--target)

The Playground API client can be initialized with a [JSON Blueprint](https://developer.wordpress.org/playground/blueprints).
This is a convenient way of preconfiguring it in any way you like without worrying
about progress bars and fetching remote files:

    ```typescript
    const client = await startPlaygroundWeb({
        iframe: document.getElementById('wp'),
        remoteUrl: `https://playground.wordpress.net/remote.html`,
        blueprint: {
            preferredVersions: {
                wp: '6.3',
                php: '8.3',
            },
            steps: [
                { step: 'login' },
                {
                    step: 'installPlugin',
                    pluginData: {
                        resource: 'wordpress.org/plugins',
                        slug: 'gutenberg',
                    },
                },
            ],
        },
    });
    await client.isReady();
    ```

Running a JSON Blueprint is only possible during the initialization of the API client.

If this is sufficient for your needs, read more about [JSON Blueprints](https://developer.wordpress.org/playground/blueprints).

If you need to work with an already initialized client, you should look into [Blueprint functions](https://developer.wordpress.org/playground/developers/apis/javascript-api/blueprint-functions-in-api-client).

First published

July 15, 2026

Last updated

July 16, 2026

Edit article

[ Improve it on GitHub: Blueprints JSON and the API Client ](https://raw.githubusercontent.com/WordPress/wordpress-playground/trunk/packages/docs/site/docs/developers/06-apis/javascript-api/04-blueprint-json-in-api-client.md)

Changelog

[ See list of changes: Blueprints JSON and the API Client ](https://developer.wordpress.org/playground/developers/apis/javascript-api/blueprint-json/?output_format=md#)

[  Previous: Playground API Client](https://developer.wordpress.org/playground/developers/apis/javascript-api/playground-api-client/)

[  Next: Blueprints Functions and the API Client](https://developer.wordpress.org/playground/developers/apis/javascript-api/blueprint-functions/)