Compatibility
Requirements
Section titled “Requirements”| Minimum | |
|---|---|
| WordPress | 6.6 (tested up to 7.1) |
| PHP | 8.1 |
| Storage | An Amazon S3, Cloudflare R2, DigitalOcean Spaces, Backblaze B2 or Wasabi bucket, or any S3-compatible storage |
Your server must be able to make outgoing HTTPS requests to your storage provider. WP-CLI is optional.
Hosting
Section titled “Hosting”OmniOffloader is built to run on a small shared hosting plan as well as on a VPS or dedicated server.
- One PHP process, low memory. Bulk jobs run in the background, one short pass at a time. A faster Transfer Speed moves several files side by side in the same process instead of starting extra workers.
- You choose the pace. Low for small shared plans, Balanced (the default) for most sites, Fast or Custom for a VPS or dedicated server. See Transfer Speed.
- Time limits. Background passes adjust to your host’s
max_execution_time. A file cut short by a time limit is reported and skipped instead of retried forever. - Blocked loopback requests. If your host blocks WordPress’s internal background requests, the open admin screen keeps the job moving.
- Storage quotas. On cPanel, Bring Back reads your plan’s real space left. See Troubleshooting.
Caching plugins and object caches
Section titled “Caching plugins and object caches”- Page caches: the plugin’s own REST requests tell page caches not to store them, including LiteSpeed Cache and Breeze. Progress bars stay live.
- Object caches: bulk progress stays live under Redis and Memcached.
- Front end: the plugin only rewrites URLs. It adds no database queries per image. Media blocks on a page are loaded in one batch before they render.
Content and page builders
Section titled “Content and page builders”Media URLs are rewritten as pages render, without editing your content:
- Image, gallery, video, audio, file, cover and media-text blocks.
- Classic Editor media tags (
<img>,<video>,<audio>,<source>) and audio/video shortcodes. - Featured images, attachment URLs and responsive
srcsetattributes. - Modern image formats: WebP/AVIF sources and the
-scaledversion are offloaded with the original.
Page builders and themes that use WordPress’s standard image functions get cloud URLs automatically. A third-party block that stores an attachment ID in an id or mediaId attribute can be added with the omnioffloader_media_block_names filter.
Multilingual sites
Section titled “Multilingual sites”Safe mode and the shared-bucket check identify your site by its saved Site Address. Multilingual plugins that use a different domain per language, such as WPML and Polylang, are never mistaken for a copy of the site or for another site.
Multisite
Section titled “Multisite”Supported per site. Each site in a network has its own settings, credentials and background queues.
Migration and backup plugins
Section titled “Migration and backup plugins”When a backup or migration plugin, or your host’s staging tool, makes a copy of your site, the copy is recognised automatically and runs in Safe mode. It never uploads to or deletes from the live site’s cloud storage.