What Is WordPress Playground?
WordPress Playground is a browser-based WordPress instance that runs entirely in your browser without any server, database setup, or installation. It uses WebAssembly, SQLite, and Service Workers to create a complete WordPress environment instantly. This revolutionary tool was introduced during State of the Word 2022 by Matt Mullenweg, who described it as a "virtual machine" for WordPress.
Key capabilities:
- Instant access to WordPress without hosting
- Test themes and plugins safely
- Support for multiple WordPress and PHP versions
- Export and import complete sites
- Perfect for learning, testing, and development
For nearly two decades, WordPress has marketed itself on being able to set up a website in just five minutes. Yet even that streamlined process involved finding hosting, configuring databases, and running installation scripts. WordPress Playground removes every one of these barriers. There is no hosting to research, no database to configure, and no files to upload. The moment you open Playground, WordPress is ready to use.
If you're new to WordPress development, consider pairing Playground with our guide to mastering WordPress shortcodes for a comprehensive learning experience.
Zero Setup Required
Open your browser and WordPress is ready instantly. No servers, no databases, no configuration.
Safe Testing Environment
Experiment with themes and plugins without risking your live site. Refresh for a clean slate.
Version Compatibility
Test across different WordPress and PHP versions to ensure compatibility before deployment.
Portable Sites
Export your configured site as a zip file or save it for later sessions.
Free and Accessible
No cost, no hosting required, works in any modern browser.
How WordPress Playground Works
Core Technologies
WebAssembly (Wasm) PHP has been compiled to WebAssembly, allowing it to run directly in your browser. This is the breakthrough that makes WordPress Playground possible - no server-side PHP required. WebAssembly serves as the computational engine powering WordPress Playground, bringing near-native performance to web applications and enabling complex interpreted languages like PHP to execute within the browser's secure sandbox.
SQLite Database Instead of MySQL, Playground uses SQLite - a lightweight, file-based database that stores everything in a single file within your browser. The SQLite database file serves as a complete, self-contained representation of the WordPress installation: posts, pages, comments, user accounts, and settings all exist within this single file. There is no database server to configure, no connection credentials to manage, and no risk of database-related errors disrupting the testing experience.
Service Workers These browser APIs handle background tasks and request management, enabling PHP execution and WordPress operations to run smoothly without blocking the main browser thread. They also enable offline functionality and improved performance. By routing WordPress operations through Service Workers and Worker Threads, Playground maintains responsiveness while handling the complex processing that powers WordPress.
What This Means for You
These technologies combine to create a complete, functional WordPress environment that runs entirely in your browser. You get real WordPress functionality without any of the traditional infrastructure requirements.
Getting Started in Under 5 Minutes
Launching Playground
- Open your browser and go to playground.wordpress.net or wordpress.org/playground
- Wait a few seconds for the WordPress environment to initialize
- You now have a complete, functional WordPress installation
Upon loading, Playground displays a fully functional WordPress site using a default theme. You can navigate to /wp-admin/ just as you would on any WordPress site to access the full range of WordPress configuration options. The initial load typically takes only a few seconds as the WebAssembly modules initialize and the WordPress environment bootstraps.
Configuring Your Environment
Click the gear icon (Settings) in the top-right corner to customize:
- WordPress Version: Choose stable releases or "Nightly" for development builds
- PHP Version: Select PHP 7.4, 8.0, 8.1, 8.2, or 8.3
- Admin Language: Configure the dashboard language
- Network Access: Enable for plugin/theme directory installation
Selecting the appropriate WordPress version is crucial for accurate testing. The settings panel offers all stable WordPress releases, allowing you to test compatibility with specific versions you run in production. For developers preparing for upcoming WordPress releases, the "WordPress Nightly" option provides access to the latest development build.
Start Testing Immediately
Navigate to /wp-admin/ to access the full WordPress dashboard. Install themes, activate plugins, create content - everything works exactly like a standard WordPress site. Whether you're exploring our CMS development services or building your own solutions, Playground provides the perfect sandbox.
For developers looking to deepen their WordPress expertise, our comprehensive guide on where to learn WordPress theme development offers structured learning paths.
Testing Themes and Plugins Safely
Theme Testing
Navigate to Appearance > Themes in the WordPress admin to:
- Browse and install free themes from the directory
- Upload custom or premium themes via zip file
- Test your theme across different WordPress versions
- Verify block patterns and full-site editing functionality
For theme developers, Playground provides an ideal environment for quality assurance. Rather than maintaining multiple WordPress installations for compatibility testing, you can open fresh Playground instances configured with different WordPress and PHP versions. Test your theme's behavior, identify compatibility issues, and verify fixes - all without leaving your browser.
Plugin Compatibility
In Plugins, you can:
- Install free plugins from the WordPress directory
- Test paid plugins by uploading their zip files
- Verify compatibility with your existing plugin combination
- Check for errors or warnings before production deployment
The critical value of plugin testing in Playground lies in risk mitigation. WordPress sites face significant security and stability risks from poorly coded or incompatible plugins. By testing plugins in Playground before deploying them, you can identify potential conflicts with your existing plugins, verify compatibility with your WordPress version, and assess any errors or warnings that might indicate underlying issues.
Version Testing Workflow
1. Open Playground with WordPress 6.5 + PHP 8.2
2. Install and configure your plugins/themes
3. Test functionality and identify issues
4. Open new Playground with different versions
5. Compare behavior across versions
This approach lets you verify compatibility without maintaining multiple local environments. Testing plugins across different PHP versions is particularly valuable given the diversity of hosting environments in the WordPress ecosystem.
Saving and Exporting Your Work
Browser Storage (Temporary)
Use the Site Manager to save your current state in your browser. This preserves your configuration between sessions without downloading files. Browser-based saving works through the browser's local storage or IndexedDB capabilities, depending on the amount of data being stored.
Best for: Ongoing projects you need to return to, quick save during testing sessions.
This save functionality is ideal for ongoing development projects where you need to return to your testing environment over multiple sessions. You can set up a Playground with specific plugins, themes, and configurations, save that state, and return to it repeatedly without rebuilding your testing environment from scratch each time.
Export as Zip (Permanent)
Export your complete site as a zip archive containing:
- All WordPress core files
- Installed plugins and activated themes
- Uploaded media files
- SQLite database at
wp-content/database/.ht.sqlite
Best for: Backups, sharing with team members, migrating to production.
The exported zip file follows the standard WordPress directory structure, making it compatible with standard WordPress deployment workflows. This export capability serves multiple purposes: it provides a backup of your testing work, enables sharing a configured Playground instance with team members or clients, and facilitates the migration of content from Playground to a production WordPress environment.
Importing Previously Exported Sites
Use the import function to restore a zip export. The import functionality reverses the export process, accepting a previously exported zip file and recreating its contents within a new Playground instance. This capability is valuable when returning to saved work or when receiving a configured environment from a team member.
Note: Files starting with a dot (like .ht.sqlite) are hidden by default on most operating systems.
Advanced Features: APIs and Automation
Query API (URL-Based Configuration)
Configure Playground through URL parameters for shareable, reproducible environments:
?wp=6.5&php=8.2 # WordPress 6.5 with PHP 8.2
?plugin=woocommerce # Auto-install WooCommerce
?theme=twentytwentyfour # Activate specific theme
?wp=6.5&php=8.2&plugin=woocommerce&plugin=gravity-forms
The basic parameters control core version selection: use wp=6.5 to specify WordPress version 6.5, or php=8.2 to specify PHP version 8.2. These URL-based configurations create shareable, reproducible environments for documentation, demonstrations, and consistent testing scenarios.
Blueprints (JSON Configuration)
Blueprints are JSON files that define complete Playground configurations:
- WordPress and PHP versions
- Plugins to install and activate
- Theme to use
- Initial content and settings
Blueprints excel in scenarios requiring consistent, reproducible environments. Quality assurance teams can define test environments as Blueprints, ensuring every tester works with identical configurations. Documentation can include Blueprints that let readers experience exactly what the documentation describes.
Embedding Playground
Embed Playground in other websites using iframes for:
- Documentation with live examples
- Learning platforms with hands-on exercises
- Product demonstrations
The standard approach to embedding uses HTML iframes, which display the Playground URL within a designated area of your page. This approach works with minimal configuration for documentation sites, learning platforms, and product documentation.
Note: Some browser restrictions may affect iframe functionality.
Frequently Asked Questions
Sources
- WordPress Playground Official Site - Primary playground instance for testing
- WordPress.org Playground Page - Official WordPress.org Playground landing
- GitHub Repository - Source code and development
- WordPress Developer Documentation - Technical background on Wasm and PHP in browser
- Smashing Magazine - WordPress Playground: From 5-Minute Install To Instant Spin-Up - Comprehensive technical deep-dive
- WPBeginner - WordPress Playground How to Use - Beginner-focused tutorial