Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Speed & performance · Info

WP Rocket Import Settings Explained: What Each Option Does

WP Rocket Import Settings Explained: What Each Option Does

Short answer

WP Rocket import settings, in the Tools tab of the WP Rocket screen, let you upload a JSON file exported from another site. The import replaces your current options with the values in that file, so you can copy a tested setup between sites in seconds.

Key takeaways

  • Import and export live in the WP Rocket Tools tab.
  • Exports are JSON files that hold all WP Rocket options.
  • An import replaces current settings rather than merging them.
  • Check URLs, exclusions and CDN details after importing.
  • Use the same WP Rocket version on both sites.

What are the WP Rocket import settings?

WP Rocket import settings let you upload a JSON file of WP Rocket options exported from another site, so the same caching, file optimisation and media settings apply without setting each option by hand.

The feature sits in the Tools tab of the WP Rocket settings page, next to Export settings and Rollback.

It is most useful when you move a site, copy settings from staging to live, or reuse a tested setup across several client sites.

WP Rocket's guide to the Tools tab, export and import settings is the official reference. This article explains what each option does and what to watch for.

Where do you find the WP Rocket import settings?

Go to Settings > WP Rocket in your WordPress dashboard, click the Tools tab, and you will see Export settings, Import settings and Rollback options on the same screen.

  1. Log in as an Administrator.
  2. Go to Settings > WP Rocket.
  3. Click Tools in the left menu of the WP Rocket screen.
  4. Find Export settings and Import settings.

If you do not see the Tools tab, check that you are using WP Rocket itself and not a host's built-in cache. Some managed hosts also restrict certain WP Rocket features.

What does the Export settings option do?

Export settings downloads a JSON file containing your current WP Rocket options, which you keep as a backup or import into another site.

Click Download settings and your browser saves the file. The file name usually includes your site name and the date.

The file is plain text in JSON format. It lists each WP Rocket option name with its value, such as whether a feature is on and which URLs are excluded.

Keep a copy each time you make big changes. If a new setting breaks your site, you can import the previous file and return to a working setup quickly.

What does the Import settings option do?

Import settings reads an exported WP Rocket JSON file and replaces your current WP Rocket options with the values in that file, then saves them as the active configuration.

  1. Click Choose file under Import settings.
  2. Select the JSON file you exported earlier.
  3. Click Upload file and import settings.
  4. Wait for the success message.
  5. Clear the WP Rocket cache.
  6. Test the site in a private window.

The import overwrites the current settings. It does not merge them, so any options you set on the destination site are replaced.

Export the destination site's settings before you import. That gives you a quick way back if the imported setup does not suit it.

Which settings carry over in an import?

An import carries over the options stored in WP Rocket's settings, such as cache, file optimisation, media, preload, advanced rules, database and add-on options, along with URL exclusion lists.

Settings areaWhat carries overWhat to recheck
CacheMobile cache, logged-in user cache, lifespanWhether the new host needs different rules
File optimisationMinify, combine, defer, delay JavaScript, remove unused CSSExclusions that name old plugins or themes
MediaLazy load, image dimensionsTheme-specific exclusions
PreloadPreload and link preload optionsSitemap URLs pointing at the old domain
Advanced rulesNever-cache URLs, cookies, user agentsPaths that differ on the new site
Add-ons and CDNToggle states and CDN hostnamesCredentials and CDN zones

Some values are site-specific. URLs, sitemap addresses and CDN hostnames may point to the old site and need updating.

Account-level details, such as your licence connection and API credentials for services like Cloudflare, should be checked after the import. Re-enter anything that does not carry over.

What should you check after importing WP Rocket settings?

After importing, clear the cache, check exclusion lists and URLs for the old domain, test key pages and forms while logged out, and confirm Core Web Vitals have not got worse.

  1. Click Clear and preload cache on the WP Rocket dashboard.
  2. Search exclusion fields for the old domain name and fix any matches.
  3. Check that the CDN and preload sitemap URLs are correct.
  4. Test menus, sliders, forms and checkout in a private window.
  5. Open the browser console and look for JavaScript errors.
  6. Run a speed test and compare with earlier results.

The JavaScript options are the most likely to cause problems. A delay or defer exclusion that worked for one theme may not suit another.

Our guide on how to clear the WP Rocket cache covers the clearing step.

If something breaks, see how to fix WP Rocket breaking your site.

When should you use WP Rocket import settings?

Use import settings when you migrate a site, push a tested staging setup to production, restore a known-good configuration, or apply a standard baseline across several similar sites.

  • Site migration: Export before the move, then import on the new host.
  • Staging to live: Tune settings on staging, then copy them across.
  • Recovery: Reimport a saved file after a bad change.
  • Agency baseline: Start new client sites from a tested default, then adjust.

Avoid copying settings between very different sites. A WooCommerce store and a simple blog need different cache and JavaScript rules.

Our WP Rocket settings guide explains each option, which helps when you adjust an imported baseline.

Why does the WP Rocket import fail?

A WP Rocket import usually fails because the file is not a valid WP Rocket JSON export, the file was edited and broken, WordPress or a security plugin blocks JSON uploads, or your user lacks permission.

Error or symptomLikely causeFix
Invalid file or wrong file typeNot a WP Rocket export, or renamed fileExport again from the source site
Upload blockedSecurity plugin or upload restrictionsAllow the upload briefly, then re-enable
No change after importCache not clearedClear and preload the cache
Permission messageUser is not an AdministratorLog in with an Administrator account
Settings look partly wrongFile from a much older WP Rocket versionUpdate WP Rocket on both sites first

WordPress limits which file types can be uploaded, controlled by the upload_mimes filter. Security plugins sometimes tighten these rules further.

If you edited the JSON by hand, a single missing comma breaks it. Export a fresh copy rather than repairing the file.

Running the same WP Rocket version on both sites avoids most mismatches. Our guide on how to update WP Rocket explains how.

What does the Rollback option do?

Rollback reinstalls the previous version of WP Rocket, which helps when a new plugin update causes a problem, and it is separate from importing or exporting settings.

Your settings stay in place when you roll back. Only the plugin files change.

Use rollback as a short-term fix while you report the problem. Stay on the older version only until a fixed release is out.

Do imported settings affect site speed?

Imported settings affect speed exactly as they would if you set them by hand, so a good baseline can improve Core Web Vitals quickly, while a poor match can break layouts or scripts.

Measure before and after the import. The Core Web Vitals overview on web.dev explains the metrics to compare.

For a deeper tuning process, see how to configure WP Rocket for Core Web Vitals.

Which WP Rocket import tips matter most?

The most important tips are to export the destination site's settings first, use files from the same WP Rocket version, update any site-specific URLs, and clear and test the cache straight after importing.

Treat an import as a starting point, not a finished job. Each site has its own theme, plugins and traffic, and the best settings follow from those.

Frequently asked questions

Where is the import option in WP Rocket?

Go to Settings, then WP Rocket, and open the Tools tab. The Import settings section lets you choose a JSON file and upload it. Export settings and Rollback are on the same screen.

Does importing WP Rocket settings transfer the licence?

Treat the licence separately. After importing, check that the WP Rocket licence is active on the new site and reconnect it if needed. Also recheck any third-party credentials such as Cloudflare details.

Can I import WP Rocket settings into an older version?

It may partly work, but options added in newer versions can be ignored or set incorrectly. Update WP Rocket on both sites to the same version before exporting and importing for the most reliable result.

Why did my WP Rocket import do nothing?

The cache may still be serving old pages, so clear and preload the cache after importing. If the settings screen still shows old values, the file may be invalid or the upload was blocked by a security plugin.

Is it safe to share a WP Rocket settings file?

Usually yes, as it mainly holds option values, but check it before sharing. It can contain site URLs, exclusion paths and CDN hostnames that reveal details about your setup, so share it only with people you trust.

Sources

  1. Tools tab: export, import settings and version rollback WP Rocket
  2. What exactly does WP Rocket do? WP Rocket
  3. upload_mimes hook WordPress Developer Resources
  4. Introducing JSON JSON.org
  5. Web Vitals web.dev

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.