roots/wordpress is a meta-package that provides WordPress core installation via Composer. It's part of the Roots WordPress packaging ecosystem, which includes several packages to give you flexibility in how WordPress is installed.
Packages
| Package | Description | Includes |
|---|---|---|
| roots/wordpress | Meta-package (recommended) | Installs roots/wordpress-no-content |
| roots/wordpress-full | Full WordPress build | Core, official themes, Akismet & Hello Dolly, beta & RC releases |
| roots/wordpress-no-content | Minimal WordPress build | Core only — no themes, plugins, or beta releases |
Getting started
Most projects should use roots/wordpress, which installs WordPress core without default themes or plugins. This is the recommended package for Bedrock projects and modern WordPress development.
composer require roots/wordpress
A WordPress Core Installer package is required to handle the installation path. We provide roots/wordpress-core-installer for this.
Example configurations
Standard (recommended)
WordPress core without default themes or plugins. Manage your themes and plugins individually via Composer with WP Composer.
{
"repositories": [
{
"name": "wp-composer",
"type": "composer",
"url": "https://repo.wp-composer.com",
"only": ["wp-plugin/*", "wp-theme/*"]
}
],
"require": {
"composer/installers": "^2.2",
"roots/wordpress": "^6.8",
"roots/wordpress-core-installer": "^1.0",
"wp-plugin/woocommerce": "^10.0",
"wp-theme/twentytwentyfive": "^1.0"
},
"config": {
"allow-plugins": {
"composer/installers": true,
"roots/wordpress-core-installer": true
}
}
}
Full build
Includes default themes, Akismet, Hello Dolly, and beta/RC releases. Closest to a standard WordPress download.
{
"require": {
"roots/wordpress-core-installer": "^1.0",
"roots/wordpress-full": "^6.8"
},
"config": {
"allow-plugins": {
"roots/wordpress-core-installer": true
}
}
}
Using Bedrock?
All of this is already configured for you. Bedrock is a WordPress boilerplate with Composer, better configuration, and an improved folder structure.
Learn more about Bedrock