wp export

Exports WordPress content to a WXR file.

In this article

Generates one or more WXR files containing authors, terms, posts, comments, and attachments. WXR files do not include site configuration (options) or the attachment files themselves.

Options

[--dir=<dirname>]
Full path to directory where WXR export files should be stored. Defaults to current working directory.
[--stdout]
Output the whole XML using standard output (incompatible with –dir=)
[--skip_comments]
Don’t include comments in the WXR export file.
[--max_file_size=<MB>]
A single export file should have this many megabytes. -1 for unlimited. -– default: 15 -–
[--filename_format=<format>]
Use a custom format for export filenames. Defaults to ‘{site}.wordpress.{date}.{n}.xml’.
[--include_once=<before_posts>]
Include specified export section only in the first export file. Valid options are categories, tags, nav_menu_items, custom_taxonomies_terms. Separate multiple sections with a comma. Defaults to none.
[--allow_orphan_terms]
Export orphaned terms with parent=0, instead of throwing an exception.

Filters

[--start_date=<date>]
Export only posts published after this date, in format YYYY-MM-DD.
[--end_date=<date>]
Export only posts published before this date, in format YYYY-MM-DD.
[--post_type=<post-type>]
Export only posts with this post_type. Separate multiple post types with a comma. -– default: any -–
[--post_type__not_in=<post-type>]
Export all post types except those identified. Separate multiple post types with a comma. Defaults to none.
[--post__in=<pid>]
Export all posts specified as a comma-separated or space-separated list of IDs. Post’s attachments won’t be exported unless –with_attachments is specified.
[--with_attachments]
Force including attachments in case –post__in has been specified.
[--start_id=<pid>]
Export only posts with IDs greater than or equal to this post ID.
[--max_num_posts=<num>]
Export no more than <num> posts (excluding attachments).
[--author=<author>]
Export only posts by this author. Can be either user login or user ID.
[--category=<name|id>]
Export only posts in this category.
[--post_status=<status>]
Export only posts with this status.

Examples

# Export posts published by the user between given start and end date
$ wp export --dir=/tmp/ --user=admin --post_type=post --start_date=2011-01-01 --end_date=2011-12-31
Starting export process...
Writing to file /tmp/staging.wordpress.2016-05-24.000.xml
Success: All done with export.

# Export posts by IDs
$ wp export --dir=/tmp/ --post__in=123,124,125
Starting export process...
Writing to file /tmp/staging.wordpress.2016-05-24.000.xml
Success: All done with export.

# Export a random subset of content
$ wp export --post__in="$(wp post list --post_type=post --orderby=rand --posts_per_page=8 --format=ids)"
Starting export process...
Writing to file /var/www/example.com/public_html/staging.wordpress.2016-05-24.000.xml
Success: All done with export.

Global Parameters

These global parameters have the same behavior across all commands and affect how WP-CLI interacts with WordPress.
Argument Description
--path=<path> Path to the WordPress files.
--url=<url> Pretend request came from given URL. In multisite, this argument is how the target site is specified.
--ssh=[<scheme>:][<user>@]<host\|container>[:<port>][<path>] Perform operation against a remote server over SSH (or a container using scheme of “docker”, “docker-compose”, “docker-compose-run”, “vagrant”).
--http=<http> Perform operation against a remote WordPress installation over HTTP.
--user=<id\|login\|email> Set the WordPress user.
--skip-plugins[=<plugins>] Skip loading all plugins, or a comma-separated list of plugins. Note: mu-plugins are still loaded.
--skip-themes[=<themes>] Skip loading all themes, or a comma-separated list of themes.
--skip-packages Skip loading all installed packages.
--require=<path> Load PHP file before running the command (may be used more than once).
--exec=<php-code> Execute PHP code before running the command (may be used more than once).
--context=<context> Load WordPress in a given context.
--[no-]color Whether to colorize the output.
--debug[=<group>] Show all PHP errors and add verbosity to WP-CLI output. Built-in groups include: bootstrap, commandfactory, and help.
--prompt[=<assoc>] Prompt the user to enter values for all command arguments, or a subset specified as comma-separated values.
--quiet Suppress informational messages.

Command documentation is regenerated at every release. To add or update an example, please submit a pull request against the corresponding part of the codebase.