URL rewriting not working
Use these checks when media still loads from your own server address instead of your CDN. The usual causes are that rewriting is off, the file is not offloaded, or a page cache is serving old HTML.
Check 1: Is URL rewriting enabled?#

Go to Media Cloud > Settings and find the Offload Behaviour card. Rewrite URLs must be on; it is the main switch for all URL rewriting. When it is off, no address is rewritten, even for offloaded files. The URL Rewriting row on the Health page warns when it is off.
Check 2: Has the file been offloaded?#
WP Media Cloud only rewrites addresses of files that are in your bucket. A file uploaded before the plugin was set up, or whose offload failed, keeps its local address.
- Go to Media > Library and open the image. The WP Media Cloud field says Offloaded for files in the bucket; in list view, they show In cloud under the file name.
- If it is not offloaded, use the Offload to cloud bulk action, or Offload All Media on the Dashboard. Check the Dashboard’s failed list for errors.
- Reload the page. The address should now be rewritten.
Check 3: Is a page cache serving stale HTML?#
Caching plugins store finished pages. Pages cached before setup, or before the bulk offload finished, still contain local addresses, and rewriting never runs for them.
- Clear your page cache after setting up the plugin and after a bulk offload.
- If you use a CDN with full-page caching, purge that too.
Check 4: Where do the addresses live?#
WP Media Cloud switches image addresses in post content, page builder data, custom fields and Kadence theme and block output as pages load. It matches every form an address is saved in: http:// on an https site, //, with or without www, and JSON-escaped. Addresses it cannot reach:
- written into theme template files. Fix: change the template to use WordPress attachment functions such as
wp_get_attachment_url()orwp_get_attachment_image(). - printed by a plugin that does not pass its output through WordPress content filters
- for files outside
wp-content/uploads - on another domain, such as an old domain from before a migration
For addresses saved in the database, the URL Replace tool can make the change permanent. Its preview shows every linked file and why any of them cannot be switched.
Check 5: Is EWWW Easy IO active?#
With EWWW Easy IO selected as your CDN and a site chosen in CDN Site, WP Media Cloud rewrites offloaded files to your Easy IO address. When ExactDN is active and no CDN URL is saved, ExactDN rewrites the addresses instead of WP Media Cloud.
- In the EWWW Image Optimizer settings, check Easy IO is on and an ExactDN domain is assigned.
- In your provider’s CDN card, click Load sites, select your site in CDN Site and save, so the Easy IO address is used as the CDN URL.
- To have WP Media Cloud serve a different CDN, choose it in the CDN card, such as Custom CDN with your CDN hostname, and save.
Check 6: Is the CDN URL set correctly?#

Symptom: addresses point at the bucket instead of your CDN hostname.
- Go to Media Cloud > Settings and find your provider’s CDN card.
- Check the CDN is not set to Direct Bucket, which serves files from the bucket’s own address.
- Choose your CDN and set its CDN URL (or select its pull zone, zone or resource).
- Click Save Settings, then Update all media URLs under Apply to Existing Media, and clear your page cache.
Check 7: On a Kadence site, are you on 1.2.1 or later?#
On the Kadence theme, Customizer backgrounds, header and footer HTML, and Kadence Blocks background images are printed outside the post content. Versions before 1.2.1 left them on your server. Update the plugin, clear your page cache, and check the Kadence card under Media Cloud > Integrations shows Active. See Kadence.