Docs

Installation

4 min readUpdated November 9, 2026

WP Media Cloud installs like any other WordPress plugin, from a zip file. This page covers the zip upload, a manual upload by SFTP, multisite network activation and updates.

Before you start#

  • Check that your site runs WordPress 7.1 or newer and PHP 8.3 or newer. See Requirements.
  • Download the plugin zip from your customer dashboard. WP Media Cloud is not listed on WordPress.org.
  • Keep the file zipped for the upload method.

Install from the zip file#

Setup wizard that opens after activation
  1. In the WordPress admin, go to Plugins > Add New Plugin.
  2. Click Upload Plugin at the top of the screen.
  3. Choose the wp-media-cloud zip file and click Install Now.
  4. When WordPress reports that the plugin is installed, click Activate Plugin.

After activation, Media Cloud appears in the admin menu. Click it to start the setup wizard. See First-time setup.

On activation, the plugin creates its own database table for offload records. It does not change your existing media or move any files.

Install by SFTP#

Use this method if the zip upload fails, for example because of your host’s upload size limit.

  1. Unzip the plugin file on your computer.
  2. Connect to your server by SFTP or FTP.
  3. Upload the wp-media-cloud folder to wp-content/plugins/.
  4. In the WordPress admin, go to Plugins > Installed Plugins and click Activate under WP Media Cloud.

Multisite networks#

  1. In Network Admin, go to Plugins > Add New Plugin and upload the zip as above.
  2. On Plugins > Installed Plugins, click Network Activate under WP Media Cloud.

Network activation creates the offload table on every subsite. Subsites added later get their table the first time the plugin loads on them.

After network activation:

  • Each subsite gets its own Media Cloud menu. Run the setup wizard on each subsite you want to offload.
  • Network Admin gets a Media Cloud menu with the WP Media Cloud: Network Overview page. It shows each subsite’s provider, progress, failed items and status.
  • Subsites can share one bucket when Path prefix is set to sites/%site_id% on each. Otherwise give each subsite its own bucket. See Custom path prefix.

You can also activate the plugin on single subsites instead of the whole network.

If your server is too old#

WordPress will not activate WP Media Cloud on a site with WordPress older than 7.1 or PHP older than 8.3.

If an existing install receives this version on an older server, the plugin pauses itself. Administrators see this notice:

WP Media Cloud needs PHP 8.3 or newer and WordPress 7.1 or newer. This site runs PHP x and WordPress y, so the plugin is paused and media URLs are not rewritten to your CDN until you upgrade.

While paused, media loads from your server. Files whose local copies were removed will not load until you upgrade PHP or WordPress. Your settings and offload records are kept.

Updates#

Updates arrive through the normal WordPress update screens, Dashboard > Updates and Plugins > Installed Plugins. Activate your licence key to receive them. See Activating your licence.

To update by hand, upload the new zip on Plugins > Add New Plugin > Upload Plugin and choose Replace current with uploaded. Do not upload it under a different folder name: WordPress then keeps two copies, and only one of them is active.

After an update, the Media Cloud screens load the new version straight away. If your browser or a cache still holds the old screen, it reloads itself once. See Settings screen shows an old version.

Two copies installed#

Notice listing two installed copies of WP Media Cloud

When more than one copy of WP Media Cloud is installed, for example wp-media-cloud and wp-media-cloud-1, the Plugins screen and the Media Cloud screens show a notice. It names each copy, its folder, its version and which one is active. Keep the newest copy active and delete the others from Plugins > Installed Plugins. With 1.2.5 or newer active, deleting another copy leaves your settings and records alone, because the active copy still uses them. With 1.2.4 or older active, deleting a copy on the Plugins page runs its uninstall routine, which removes the settings, licence and offload records both copies share: update to 1.2.5 first, or remove the extra folder by SFTP or your host’s file manager.

Deactivating and deleting#

Deactivating stops WP Media Cloud and its scheduled tasks. Media URLs return to your server at once. Settings, records and files in your bucket are kept.

If you turned on Remove local files, restore your files first. Use Download All to Server on the Dashboard tab or run wp wpmc restore. Otherwise those files will not load after you deactivate.

Deleting the plugin from the Plugins screen also removes its settings, licence data and offload records from the database. Files in your bucket are not deleted. Without the records, a later reinstall no longer knows which files are offloaded, so restore local files before you delete the plugin.

Next steps#

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only