Create a distribution .zip or .tar.gz based on a plugin or theme’s .distignore file.

runcommand open source CircleCI

Quick links: Using | Installing | Support


wp dist-archive <path> [<target>] [--format=<format>]

For a plugin in a directory ‘wp-content/plugins/hello-world’, this command
creates a distribution archive ‘wp-content/plugins/’.

You can specify files or directories you’d like to exclude from the archive
with a .distignore file in your project repository:


Use one distibution archive command for many projects, instead of a bash
script in each project.


	Path to the project that includes a .distignore file.

	Path and file name for the distribution archive. Defaults to project directory name plus version, if discoverable.

	Choose the format for the archive.
	default: zip
	  - zip
	  - targz


Installing this package requires WP-CLI v0.23.0 or greater. Update to the latest stable release with wp cli update.

Once you’ve done so, you can install this package with wp package install runcommand/dist-archive.


This WP-CLI package is free for anyone to use. Support, including usage questions and feature requests, is available to paying runcommand customers.

Think you’ve found a bug? Before you create a new issue, you should search existing issues to see if there’s an existing resolution to it, or if it’s already been fixed in a newer version. Once you’ve done a bit of searching and discovered there isn’t an open or fixed issue for your bug, please create a new issue with description of what you were doing, what you saw, and what you expected to see.

Want to contribute a new feature? Please first open a new issue to discuss whether the feature is a good fit for the project. Once you’ve decided to work on a pull request, please include functional tests and follow the WordPress Coding Standards.

runcommand customers can also email [email protected] for private support.