WordPress Core via Composer

Packages for installing WordPress core via Composer. Choose the build that fits your project.

16.8M total installs via Packagist

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.

composer.json
{
  "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.

composer.json
{
  "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

WP Composer is community-funded open source. Support our work by sponsoring us on GitHub.

Sponsors

Carrot Kinsta WordPress.com Itineris