The wp-toolkit utility allows you to perform certain actions on WordPress installations.

Note: This utility is available when the WordPress Toolkit extension is installed in Plesk and is used with the plesk ext utility.

Additionally, WP-CLI (official WordPress command-line interface) is integrated into wp-toolkit utility. You can invoke it with the wp-cli command and use it to manage WordPress websites.

Read more about WP-CLI.

Usage

plesk ext wp-toolkit <command> [options]

Example

The following command provides main data for all WordPress installations existing on the server:

plesk ext wp-toolkit --list

Commands

Command Parameter Description Example
--clear-cache [option]

Clears the cache of the selected WordPress installation.

Requires the following options: -instance-id | -main-domain-id and -path.

To show output in a particular format, specify the -format option. Supported formats: JSON, raw. By default all data is shown in the raw format.

To clear the cache of the WordPress installation with the ID 1:

plesk ext wp-toolkit --clear-cache -instance-id 1

--clear-wpt-cache   Clears the WordPress Toolkit cache.

To clear the WordPress Toolkit cache:

plesk ext wp-toolkit --clear-wpt-cache

--register [option]

Adds a WordPress installation to WordPress Toolkit. Requires the -main-domain-id and -path options.

To show output in a particular format, specify the -format option. Supported formats: JSON, raw. By default all data is shown in the raw format

To add the WordPress installation on the domain with the ID 1 to WordPress toolkit:

plesk ext wp-toolkit --register -main-domain-id 1 -path httpdocs

--info [option]

Displays the detailed information about the selected WordPress installation.

Requires the following options: -instance-id | -main-domain-id and -path.

To show output in a particular format, specify the -format option. Supported formats: JSON, raw. By default all data is shown in the raw format.

To display information about the WordPress installation with the ID 1:

plesk ext wp-toolkit --info -instance-id 1

--config [option]

Manages WordPress Toolkit settings.

Requires the -operation option with the following arguments: list | get | set | rollback.

If get | rollback is used, you need to specify the -option-name option.

If set is used, you need to specify the -option-name and option-value options. You cannot set read-only settings.

To show output in a particular format, specify the -format option. Supported formats: JSON, raw. By default all data is shown in the raw format.

To display a list of WordPress Toolkit settings and their values:

plesk ext wp-toolkit --config -operation list

--wp-cli [option]

Executes a wp-cli command on the selected WordPress installation.

Requires the -instance-id | -main-domain-id and -path options and a wp-cli subcommand.

To display all plugins for the WordPress installation with the ID 1:

plesk ext wp-toolkit --wp-cli -instance-id 1 -- plugin list

--list  

Displays a brief description of WordPress installations existing on the server.

To specify filters, use the following options: -main-domain-id | -plugins | -themes.

To show output in a particular format, specify the -format option. Supported formats: JSON, raw. By default all data is shown in the raw format.

To display a brief description of all WordPress installations existing on the server:

plesk ext wp-toolkit --list

--help or -h   Displays help on the use of this utility.

To view the help info on the use of this utility:

plesk ext wp-toolkit --help

or

plesk ext wp-toolkit -h

--install [option]

Installs WordPress on a domain.

Requires the -main-domain-id or -domain-name option.

Can be used with the following options: -username, -admin-email, -protocol, -path, -version, -language, -db-server, -db-name, -db-user, -table-prefix, -set-id, -site-title, -auto-updates, -plugins-auto-updates, -themes-auto-updates, -format, -show-progress.

To show output in a particular format, specify the -format option. Supported formats: JSON, raw. By default all data is shown in the raw format.

To install WordPress with the default settings on the domain example.com:

plesk ext wp-toolkit --install -domain-name example.com

--clone [option]

Clones a WordPress website to another domain and/or subdirectory.

Requires the -source-instance-id and -target-domain-name | -target-domain-id options.

Can be used with the following options: -target-path, -target-db-name, -target-db-server-id, -target-db-user-login, -force-overwrite, -show-progress.

To show output in a particular format, specify the -format option. Supported formats: JSON, raw. By default all data is shown in the raw format.

To clone the WordPress installation with the ID 1 to the target domain with the ID 2:

plesk ext wp-toolkit --clone -source-instance-id 1 -target-domain-id 2

--copy-data [option]

Copies the content of your WordPress website including files and database to another WordPress website.

Requires the -source-instance-id and -target-instance-id options.

Can be used with the following options: -data-to-copy, -files-replace-modified, -files-remove-missing, -db-tables-copy-mode, -db-tables, -exclude-db-tables, -create-restore-point, -show-progress.

To show output in a particular format, specify the -format option. Supported formats: JSON, raw. By default all data is shown in the raw format.

To copy the content of the website with the ID 1 to the website with the ID 2:

plesk ext wp-toolkit --copy-data -source-instance-id 1 -target-instance-id 2

--detach [option]

Detaches a WordPress website.

Requires the following options: -instance-id | -main-domain-id and -path.

To detach the WordPress installation with the ID 1:

plesk ext wp-toolkit --detach -instance-id 1

--languages [option]

Displays the list of languages available for the specified WordPress version. Requires the -version option.

To show output in a particular format, specify the -format option. Supported formats: JSON, raw. By default all data is shown in the raw format.

To display the list of languages available for WordPress version 4.9.8 in the JSON format:

plesk ext wp-toolkit --languages -version 4.9.8 -format json

--sets [option]

Manages sets of plugins and themes.

Requires the -operation option with the following arguments: list | info | add | remove | rename | add-plugin | add-theme | remove-plugin | remove-theme | install.

To show output in a particular format, specify the -format option. Supported formats: JSON, raw. By default all data is shown in the raw format.

To display available sets of plugins and themes:

plesk ext wp-toolkit --sets -operation list

--plugins [option]

Manages uploaded plugins.

Requires the -operation option with the following arguments: list-custom | add | remove.

To use add, you need to specify the location of the plugin you want to upload (the -source-url | -path option).

To use remove, you need to specify the ID and version of the plugin (the -id and -version options).

To show output in a particular format, specify the -format option. Supported formats: JSON, raw. By default all data is shown in the raw format.

To display all uploaded plugins:

plesk ext wp-toolkit --plugins -operation list-custom

--themes [option]

Manages uploaded themes.

Requires the -operation option with the following arguments: list-custom | add | remove.

To show output in a particular format, specify the -format option. Supported formats: JSON, raw. By default all data is shown in the raw format.

To remove the uploaded theme that has the ID 1 and the version 1.4:

plesk ext wp-toolkit --themes -operation remove -id 1 -version 1.4

--smart-update [option]

Enables and disables Smart Updates for a website.

Requires the following options: -instance-id | -main-domain-id and -path.

To show output in a particular format, specify the -format option. Supported formats: JSON, raw. By default all data is shown in the raw format.

To enable Smart Updates for the WordPress installation with the ID 1:

plesk ext wp-toolkit --smart-update -instance-id 1

--versions  

Displays available WordPress versions that can be installed via WordPress Toolkit.

To show output in a particular format, specify the -format option. Supported formats: JSON, raw. By default all data is shown in the raw format.

To display available WordPress versions that can be installed via WordPress Toolkit:

plesk ext wp-toolkit --versions

Options

Command Parameter Description Example
-instance-id <instance_id> WordPress installation ID.

To activate plugin “hello” on the WordPress installation with the ID 1:

plesk ext wp-toolkit --wp-cli -instance-id 1 -- plugin activate hello

-main-domain-id <main_domain_id> Main domain ID.

To display information about the WordPress installation with the ID 1:

plesk ext wp-toolkit --info -main-domain-id 1 -path httpdocs

-path <path> The relative path from the domain’s document root directory, for example, /subdirectory.

To add the WordPress installation on the domain with the ID 1 to WordPress Toolkit:

plesk ext wp-toolkit --register -main-domain-id 1 -path httpdocs

-plugins   Adds information about the number of plugins on WordPress installations when the list command is executed.

To display main data (including the number of plugins) on all WordPress installations existing on the server:

plesk ext wp-toolkit --list -plugins

-themes   Adds information about the number of plugins on WordPress installations when the list command is executed.

To display main data (including the number of themes) on all WordPress installations existing on the server:

plesk ext wp-toolkit --list -themes

-format raw | json Renders output in a particular format. Supported formats: JSON, raw. By default all data is shown in the raw format.

To display main data on all WordPress installations existing on the server in the JSON format:

plesk ext wp-toolkit --list -format json

-domain-id <domain-id> The domain ID.

To install WordPress with the default settings on the domain with the ID 1:

plesk ext wp-toolkit --install -domain-id 1

-domain-name <domain_name> The domain name.

To install WordPress with the default settings on the domain example.com:

plesk ext wp-toolkit --install -domain-name example.com

-operation   Necessary for certain commands to specify the corresponding operation.

To display all uploaded themes:

plesk ext wp-toolkit --themes -operation list-custom

-site-title <site_title> The website title. Used with the --install command.

To install WordPress with the site title “Example Site” on the domain with the ID 1:

plesk ext wp-toolkit --install -domain-id 1 -site-title "Example Site"

-protocol http | https The protocol name. Used with the --install command.

To install WordPress on the domain with the ID 1 and enable the website via the HTTP protocol:

plesk ext wp-toolkit --install -domain-id 1 -protocol http

-db-name <database_name> The database name. Used with the --install command.

To install WordPress on the domain with the ID 1 and name the WordPress database a1:

plesk ext wp-toolkit --install -domain-id 1 -db-name a1

-db-user <database_user>

The database user name. Used with the --install command.

To specify the database user password, use the DB_PASSWORD environment variable.

To install WordPress on the domain with the ID 1 and name the WordPress database user db_user:

plesk ext wp-toolkit --install -domain-id 1 -db-user db_user

-table-prefix <table_prefix> The table prefix. Used with the --install command.

To install WordPress on the domain with the ID 1 and name the table prefix aaa:

plesk ext wp-toolkit --install -domain-id 1 -table-prefix aaa

-db-server IP address of the remote database server | localhost:3306 The database server. Used with the --install command.

To install WordPress on the domain with the ID 1 using the local database server for hosting the WordPress database:

plesk ext wp-toolkit --install -domain-id 1 -db-server localhost:3306

-language <locale_name> The WordPress language. Used with the --install command.

To install WordPress on the domain with the ID 1 and choose the English language of the WordPress interface:

plesk ext wp-toolkit --install -domain-id 1 -language en_US

-version <version> The WordPress version. Used with the --install command.

To install WordPress version 4.9.8 on the domain with the ID 1:

plesk ext wp-toolkit --install -domain-id 1 -version 4.9.8

-admin-email <admin-email> The email of the WordPress administrator. Used with the --install command.

To install WordPress on the domain with the ID 1 and specify the email of the WordPress administrator:

plesk ext wp-toolkit --install -domain-id 1 -admin-email mail@example.com

-username <username>

Specifies the administrator username. Used with the --install command.

To specify the administrator password, use the ADMIN_PASSWORD environment variable.

To install WordPress on the domain example.com naming the administrator “WP_admin”:

plesk ext wp-toolkit --install -domain-name example.com -username WP_admin

-set-id <set_id> The ID of a set for installing or removing plugins and themes.

To add the plugin with the ID 1 to the set with the ID 1:

plesk ext wp-toolkit --sets -operation add-plugin -set-id 1 -plugin-id 1

-source-url <source_url> The source URL, by which a plugin or a theme is available (used to upload plugins and themes).

To upload a plugin available by the known URL:

plesk ext wp-toolkit --plugins -operation add -source-url https://downloads.wordpress.org/plugin/hello-dolly.1.6.zip

-plugin-id <plugin_id> The ID of an uploaded plugin. Used with the --sets command and the add-plugin and remove-plugin operations.

To add the uploaded plugin with the ID 1 to the set with the ID 1:

plesk ext wp-toolkit --sets -operation add-plugin -set-id 1 -plugin-id 1

-theme-id <theme_id> The ID of an uploaded theme. Used with the --sets command and the add-theme and remove-theme operations.

To add the uploaded theme with the ID 1 to the set with the ID 1:

plesk ext wp-toolkit --sets -operation add-theme -set-id 1 -theme-id 1

-plugin-slug <plugin_slug> The plugin slug for adding or removing plugins found in the wordpress.org repository. Used with the --sets command and the add-plugin and remove-plugin operations.

To remove the plugin with the slug “akismet” from the set with the ID 1:

plesk ext wp-toolkit --sets -operation remove-plugin -set-id 1 -plugin-slug akismet

-theme-slug <theme_slug> The theme slug for adding or removing themes found in the wordpress.org repository. Used with the -sets command and the add-theme and remove-theme operations.

To add the theme with the slug “breviter” to the set with the ID 1:

plesk ext wp-toolkit --sets -operation add-theme -set-id 1 -theme-slug breviter

-source-instance-id <source-instance-id> The source WordPress website ID. Used with the --clone and --copy-data commands.

To clone the WordPress installation with the ID 1 to the target domain with the ID 2:

`` plesk ext wp-toolkit –clone -source-instance-id 1 -target-domain-id 2``

-target-domain-name <target-domain-name> The target domain name. Used with the --clone command.

To clone the WordPress installation with the ID 1 to the target domain example.com:

plesk ext wp-toolkit --clone -source-instance-id 1 -target-domain-name example.com

-target-domain-id <target-domain-id> The target domain ID. Used with the --clone command.

To clone the WordPress installation with the ID 1 to the target domain with the ID 2:

plesk ext wp-toolkit --clone -source-instance-id 1 -target-domain-id 2

-target-path <target-path>

The path inside the target domain’s document root. Used with the --clone command.

If the option is not specified, a WordPress website is cloned to the domain root directory.

To clone the WordPress installation with the ID 1 to the target domain with the ID 2 and the subdirectory directory:

plesk ext wp-toolkit --clone -source-instance-id 1 -target-domain-id 2 -target-path subdirectory

-target-db-name <target-db-name> The target database name (generated automatically if not specified). Used with the --clone command.

To clone the WordPress installation with the ID 1 to the target domain with the ID 2 and name the created database wp_database:

plesk ext wp-toolkit --clone -source-instance-id 1 -target-domain-id 2 -target-db-name wp_database

-target-db-user-login <target-db-user-login>

The username of the target database user (generated automatically if not specified). Used with the --clone command.

To specify a password for the database user, use the TARGET_DB_USER_PASSWORD environment variable.

To clone the WordPress installation with the ID 1 to the target domain with the ID 2 and name the database user wp_user:

plesk ext wp-toolkit --clone -source-instance-id 1 -target-domain-id 2 -target-db-user-login wp_user

-target-db-server-id <target-db-server-id>

The ID of the target MySQL database server. Used with the --clone command.

If the option is not specified, the default database server is used on the target domain.

To clone the WordPress installation with the ID 1 to the target domain with the ID 2 and assign the ID 2 to the target MySQL database server:

plesk ext wp-toolkit --clone -source-instance-id 1 -target-domain-id 2 -target-db-server-id 2

-force-overwrite yes | no Used with the --clone command. If the option is set to “yes”, WordPress Toolkit overwrites data on the target domain and path ignoring any existing WordPress installations and other potential website data. The default state of the option is “no”.

To clone the WordPress installation with the ID 1 to the target domain with the ID 2 overwriting an existing WordPress installation on the target domain:

plesk ext wp-toolkit --clone -source-instance-id 1 -target-domain-id 2 -force-overwrite yes

-show-progress yes | no Manages if the progress of an operation is shown or not. By default, the option is set to “yes” and the progress is displayed (unless you specify the JSON output format). If set to “no”, the operation is performed silently.

To clone the WordPress installation with the ID 1 to the target domain with the ID 2 without showing the cloning progress:

plesk ext wp-toolkit --clone -source-instance-id 1 -target-domain-id 2 -show-progress no

-option-name <option-name> The WordPress Toolkit setting name. The option is used with the --config command and the -operation option.

To see the value of the transportOptionDelete setting:

plesk ext wp-toolkit --config -operation get -option-name transportOptionDelete

-option-value <option-value> The WordPress Toolkit setting value. The option is used with the --config command and the -operation option that has the set argument.

To set the httpTimeout setting to 10 seconds:

plesk ext wp-toolkit --config -operation set -option-name httpTimeout -option-value 10

-target-instance-id <target-instance-id> The target WordPress website ID. Used with the --copy-data command.

To copy the content of the website with the ID 1 to the website with the ID 2:

plesk ext wp-toolkit --copy-data -source-instance-id 1 -target-instance-id 2

-data-to-copy all | files | db Used with the --copy-data command. Specifies what data to copy: files and database, files only, or database only.

To copy the content of the website (files only) with the ID 1 to the website with the ID 2:

plesk ext wp-toolkit --copy-data -source-instance-id 1 -target-instance-id 2 -data-to-copy files

-files-replace-modified yes | no Used with the --copy-data command. Set to “yes” by default. When set to “yes”, it replaces files modified on the target with files from the source even if the source files are older.

To copy the content of the website with the ID 1 to the website with the ID 2 and prohibit overwriting files on the target with the files from the source that are older:

plesk ext wp-toolkit --copy-data -source-instance-id 1 -target-instance-id 2 -files-replace-modified no

-files-remove-missing yes | no Used with the --copy-data command. When set to “yes”, it removes files existing on the target but absent from the source.

To copy the content of the website with the ID 1 to the website with the ID 2 and remove files existing on the target but absent from the source:

plesk ext wp-toolkit --copy-data -source-instance-id 1 -target-instance-id 2 -files-remove-missing yes

-db-tables-copy-mode default | all | new | selected

Used with the --copy-data command. Specifies which database tables will be copied:

  • default copies all tables except for the data ones (postmeta, posts, usermeta, and users).
  • all copies all tables of the source WordPress website (you can exclude certain tables with the -exclude-db-tables option).
  • new copies tables that exist on the source WordPress website but are absent from the target WordPress site.
  • selected allows to select exact tables to copy. Requires the -db-tables option.

To copy the content of the website with the ID 1 to the website with the ID 2 copying all database tables:

plesk ext wp-toolkit --copy-data -source-instance-id 1 -target-instance-id 2 -db-tables-copy-mode all

-db-tables A comma-separated list of database tables.

Used with the --copy-data command and the -db-tables-copy-mode option that has the selected value.

Specifies which database tables to copy.

To copy the content of the website with the ID 1 to the website with the ID 2 copying the H7_posts and H7_comments database tables:

plesk ext wp-toolkit --copy-data -source-instance-id 1 -target-instance-id 2 -db-tables-copy-mode selected -db-tables H7_posts,H7_users

-exclude-db-tables A comma-separated list of database tables.

Used with the --copy-data command and the -db-tables-copy-mode option that has the all value.

Specifies which database tables to exclude from copying.

To copy the content of the website with the ID 1 to the website with the ID 2 excluding the H7_posts and H7_comments database tables from copying:

plesk ext wp-toolkit --copy-data -source-instance-id 1 -target-instance-id 2 -db-tables-copy-mode all -exclude-db-tables H7_posts,H7_users

-create-restore-point yes | no

Used with the --copy-data command. Set to “yes” by default.

When set to “yes”, it creates a restore point you can later use to revert the changes made during copying if something goes wrong.

To copy the content of the website with the ID 1 to the website with the ID 2 and not to create a restore point:

plesk ext wp-toolkit --copy-data -source-instance-id 1 -target-instance-id 2 -create-restore-point no

-username <username>

Used with the --install command. Specifies the administrator username.

To specify the administrator password, use the ADMIN_PASSWORD environment variable.

To install WordPress on the domain example.com naming the administrator “WP_admin”:

plesk ext wp-toolkit --install -domain-name example.com -username WP_admin

-auto-updates true | false | minor

Configures automatic WordPress updates. Set to minor (security) updates by default.

Used with the --install command.

To install WordPress on the domain example.com turning on all (minor and major) automatic updates:

plesk ext wp-toolkit --install -domain-name example.com -auto-updates true

-plugins-auto-updates true | false

Turns on and off automatic updates of WordPress plugins. Set to false by default.

Used with the --install command.

To install WordPress on the domain example.com turning on automatic updates of plugins:

plesk ext wp-toolkit --install -domain-name example.com -plugins-auto-updates true

-themes-auto-updates true | false

Turns on and off automatic updates of WordPress themes. Set to false by default.

Used with the --install command.

To install WordPress on the domain example.com turning on automatic updates of themes:

plesk ext wp-toolkit --install -domain-name example.com -themes-auto-updates true