Skip to main content

Guides

In this section we present a selection of guides that will help you to both work with, and to better understand, a variety of topics related to WordPress Playground.

PHP code snippets and embeds​

Embed editable, runnable PHP and WordPress examples in any web page with the <php-snippet> web component. The guide covers custom Blueprints, expected output, pure-PHP snippets, runtime sharing, and the standalone PHP Playground.

Run PHP frameworks in Playground​

Use Playground as a generic browser-based PHP runtime. This guide shows how to skip the WordPress download, load a bundled Symfony app with a Blueprint, and run it from a <php-snippet>.

WordPress Playground for Everyone​

Think Playground is only for developers? Think again. This guide shows how WordPress Playground helps beginners, site owners, and everyday users experiment safely — no technical expertise required.

How to ship a real WordPress site in a native iOS app via Playground?​

Check "Blocknotes", the first app to run WordPress natively on iOS via WordPress Playground. It showcases the potential for seamless mobile web integration using WebAssembly and the WordPress block editor.

Providing content for your demo with WordPress Playground​

To provide a good demo of your theme or plugin via Playground, you may want to load it with default content that highlights the features of your product. Check this guide to learn how to do so.

Importing content into WordPress with Blueprints​

Compare XML exports, generated PHP content, and ZIP snapshots, including their trade-offs and test results for importing the same dataset into fresh WordPress instances.

WordPress Playground for Theme Developers​

This guide will show you the essential settings to fully create a theme demo using WordPress Playground and how you can leverage it during the building stage.

WordPress Playground for Plugin Developers​

This guide will show you the basic settings to showcase your plugin using WordPress Playground and how to use it while developing your plugin.

Adding PR Preview Buttons with GitHub Actions​

Learn how to automatically add one-click preview buttons to your pull requests. When someone opens a PR on your plugin or theme repository, they get an instant link to test the changes in a fully configured WordPress instance running in the browser.

Using the WordPress Playground Agent Skill​

Automate WordPress Playground workflows with Claude Code. Learn how to install the wp-playground agent skill and use it for local testing, Blueprint execution, snapshot building, version switching, and debugging.

Programmatic Usage of Playground CLI​

Learn how to use the runCLI function to control WordPress Playground programmatically from JavaScript/TypeScript for automation, end-to-end testing, and CI/CD pipelines.

Running PHPUnit with the Playground CLI​

Run PHPUnit tests for WordPress plugins and themes using the Playground CLI — no database required, clean environment on every run.

E2E Testing with Playwright and WordPress Playground​

Set up automated end-to-end tests for your WordPress plugins and themes using Playwright and the WordPress Playground CLI.