Title: Create a Community Blueprint Author: WordPress.org Published: March 31, 2026 Last modified: June 12, 2026 --- # Create a Community Blueprint ## In this article * [Steps](https://make.wordpress.org/handbook/pathways/build/create-a-playground-blueprint-for-a-community-plugin-or-theme/?output_format=md#steps) * [Contribution checklist](https://make.wordpress.org/handbook/pathways/build/create-a-playground-blueprint-for-a-community-plugin-or-theme/?output_format=md#contribution-checklist) * [What happens next](https://make.wordpress.org/handbook/pathways/build/create-a-playground-blueprint-for-a-community-plugin-or-theme/?output_format=md#what-happens-next) * [Help](https://make.wordpress.org/handbook/pathways/build/create-a-playground-blueprint-for-a-community-plugin-or-theme/?output_format=md#help) [↑ Back to top](https://make.wordpress.org/handbook/pathways/build/create-a-playground-blueprint-for-a-community-plugin-or-theme/?output_format=md#wp--skip-link--target) Help theme and pluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory [https://wordpress.org/plugins/](https://wordpress.org/plugins/) or can be cost-based plugin from a third-party. contributors get started faster by creating a Playground Blueprint for their project. A Blueprint is a JSONJSON JSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML. file that spins up a ready-to-go WordPress instance with the right extensions and content pre-loaded — useful for demos, testing, and reviewing PRs. * **Prerequisite:** [Build a Blueprint for the Gallery](https://make.wordpress.org/handbook/pathways/build/create-a-playground-blueprint/)— learn Blueprint basics first * **Reference:** [Blueprint Steps API Reference](https://wordpress.github.io/wordpress-playground/blueprints/steps/)— keep this handy while building * **Connect:** Join [#playground](https://wordpress.slack.com/archives/playground) and introduce yourself ## 󠀁[Steps](https://make.wordpress.org/handbook/pathways/build/create-a-playground-blueprint-for-a-community-plugin-or-theme/?output_format=md#steps)󠁿 1. **Pick a project.** Find a WordPress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. [https://wordpress.org/](https://wordpress.org/) community-maintained [theme](https://profiles.wordpress.org/wordpressdotorg/#content-themes) or [plugin](https://profiles.wordpress.org/wordpressdotorg/#content-plugins) that doesn’t have a Blueprint yet. 2. **Coordinate with the team.** Check the project’s repository for an existing issue requesting a Blueprint, or open one. Reach out in the team’s SlackSlack Slack is a Collaborative Group Chat Platform [https://slack.com/](https://slack.com/). The WordPress community has its own Slack Channel at [https://make.wordpress.org/chat/](https://make.wordpress.org/chat/) channel to let them know you’d like to contribute one. 3. **Draft your Blueprint.** Create a `blueprint.json` that installs the extension, adds useful demo content, and configures the site so someone can see it working immediately. 4. **Test your Blueprint.** Run it in Playground. Try different PHPPHP PHP (recursive acronym for PHP: Hypertext Preprocessor) is a widely-used open source general-purpose scripting language that is especially suited for web development and can be embedded into HTML. [https://www.php.net/manual/en/index.php](https://www.php.net/manual/en/index.php) versions. Does everything install? Does the demo content make sense? 5. **Open a pull request.** Submit your Blueprint to the plugin or theme’s repository with a brief explanation of what it does and why it’s useful. ## 󠀁[Contribution checklist](https://make.wordpress.org/handbook/pathways/build/create-a-playground-blueprint-for-a-community-plugin-or-theme/?output_format=md#contribution-checklist)󠁿 * `blueprint.json` is clean, readable, and uses [shorthand syntax](https://wordpress.github.io/wordpress-playground/blueprints/tutorial/build-your-first-blueprint/#shorthands) where appropriate * PR explains what the Blueprint does and why * Demo content is useful and makes the Blueprint’s value obvious * Blueprint installs cleanly in Playground, tested in at least two PHP versions ## 󠀁[What happens next](https://make.wordpress.org/handbook/pathways/build/create-a-playground-blueprint-for-a-community-plugin-or-theme/?output_format=md#what-happens-next)󠁿 The plugin or theme maintainer will review your PR. If they’re unfamiliar with Blueprints, your PR description may need to explain what Playground is and how it helps. If you haven’t heard back in a week or so, try reaching out in the team’s Slack channel again. Once merged, anyone can spin up a working demo with one click. Then pick another project, or help improve the Blueprint tooling in the [Playground repository](https://github.com/WordPress/wordpress-playground). ## 󠀁[Help](https://make.wordpress.org/handbook/pathways/build/create-a-playground-blueprint-for-a-community-plugin-or-theme/?output_format=md#help)󠁿 Stuck? Check the [getting help guide](https://make.wordpress.org/handbook/pathways/before-you-begin/#getting-help), then ask in [#playground](https://wordpress.slack.com/archives/playground). **Further reading:** – [Build your first blueprint](https://wordpress.github.io/wordpress-playground/blueprints/tutorial/build-your-first-blueprint/)— refresher on the basics – [Blueprint Resources API Reference](https://wordpress.github.io/wordpress-playground/blueprints/steps/resources/)– [Create a demo with Playground](https://wordpress.tv/2025/04/30/create-a-demo-with-playground/)— 27-minute video walkthrough Build Intermediate project New here? [Get set up](https://make.wordpress.org/handbook/pathways/before-you-begin/) with accounts, community basics, and info on badges. First published March 31, 2026 Last updated June 12, 2026 Edit article [ Improve it on GitHub: [article_title] ](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fhandbook%2Fpathways%2Fbuild%2Fcreate-a-playground-blueprint-for-a-community-plugin-or-theme%2F&locale=en_US) Changelog [ See list of changes: [article_title] ](https://make.wordpress.org/handbook/pathways/build/create-a-playground-blueprint-for-a-community-plugin-or-theme/?output_format=md#) [ Previous: Build a WordPress Playground Blueprint](https://make.wordpress.org/handbook/pathways/build/create-a-playground-blueprint/) [ Next: Contribute to Theme Check Plugin](https://make.wordpress.org/handbook/pathways/build/contribute-to-theme-check-plugin/)