Settings, every option explained
Settings live under Offloft → Settings and save automatically. The defaults suit most sites, and you can leave anything in Advanced alone unless support asks. Number settings stay within an allowed range, and each one notes when it only applies to files offloaded from then on.
Connection
Your provider, keys, bucket and any region or endpoint. See connect a provider.
Delivery
| Setting | Default | What it does |
|---|---|---|
| Delivery domain | None | The address visitors load your media from. Images switch only after they load from it. |
| Force HTTPS | Off | Always serve media over a secure connection. |
| Rewrite media URLs | On | The master switch. Turning it off serves everything from your server again. |
| Versioned file paths | On | Adds a short version to each address, so browsers never show a stale copy. |
| Cache lifetime | 1 year | How long browsers and CDNs may keep a copy. Without versioned paths, 1 day at most. |
Uploads & sync
| Setting | Default | What it does |
|---|---|---|
| Offload new uploads automatically | On | New media goes up a moment after WordPress finishes creating its sizes. |
| File types to skip | None | Types to leave on your server, such as application/zip or video/*. |
| Path in bucket | wp-content/uploads/ | Where files go inside your bucket. |
| Quiet period | 30 seconds | Wait this long before uploading, so other plugins can finish editing. 5 to 3,600. |
| Delete from the cloud when deleted in the Media Library | On | Keeps your bucket tidy. |
Safety & local files
| Setting | Default | What it does |
|---|---|---|
| Keep local copies | On | Always on with Free. Pro can remove them after every size is verified. |
| Safety delay before removal (Pro) | 24 hours | Offloft re-checks once more after this wait. |
Advanced
| Setting | Default | What it does |
|---|---|---|
| Who can manage Offloft | Administrators | Who can open Offloft and change its settings. Or editors and administrators. |
| Batch size | 25 | Media items per background task. 1 to 500. |
| Concurrency | 4 | Uploads at the same time, for the sizes of one media item. 1 to 10. |
| Multipart threshold | 16 MB | Bigger files upload in parts. |
| Part size | 16 MB | The size of each part. |
| Retry failed uploads | 5 tries | How many times an upload is tried. 1 to 20. |
| Outage threshold | 5 | Failures in a row before Offloft treats the provider as down. 2 to 50. |
| Upload lease | 900 seconds | How long one worker may hold an upload before another may take over. 300 to 7,200. |
| Keep activity for | 90 days | How long the activity log is kept. 1 to 3,650. |
| Debug logging | Off | Turns itself off after 24 hours. Records requests to your storage, never keys or passwords. |
| Remove all Offloft data on uninstall | Off | Also deletes its settings, connection, file records, activity and scheduled tasks. Your files stay. |
Set in code
OFFLOFT_DELIVERY_DOMAINsets the delivery domain inwp-config.php.OFFLOFT_ENCRYPTION_KEYsets the key used to encrypt saved access keys.- The
offloft/capabilityfilter sets who can manage Offloft.