Offloft 0.1.0 is here: offload your WordPress media and know it arrived.Read what's new
Browse the docs

Settings, every option explained

Updated November 6, 2026Suggest an editView as Markdown

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

SettingDefaultWhat it does
Delivery domainNoneThe address visitors load your media from. Images switch only after they load from it.
Force HTTPSOffAlways serve media over a secure connection.
Rewrite media URLsOnThe master switch. Turning it off serves everything from your server again.
Versioned file pathsOnAdds a short version to each address, so browsers never show a stale copy.
Cache lifetime1 yearHow long browsers and CDNs may keep a copy. Without versioned paths, 1 day at most.

Uploads & sync

SettingDefaultWhat it does
Offload new uploads automaticallyOnNew media goes up a moment after WordPress finishes creating its sizes.
File types to skipNoneTypes to leave on your server, such as application/zip or video/*.
Path in bucketwp-content/uploads/Where files go inside your bucket.
Quiet period30 secondsWait this long before uploading, so other plugins can finish editing. 5 to 3,600.
Delete from the cloud when deleted in the Media LibraryOnKeeps your bucket tidy.

Safety & local files

SettingDefaultWhat it does
Keep local copiesOnAlways on with Free. Pro can remove them after every size is verified.
Safety delay before removal (Pro)24 hoursOffloft re-checks once more after this wait.

Advanced

SettingDefaultWhat it does
Who can manage OffloftAdministratorsWho can open Offloft and change its settings. Or editors and administrators.
Batch size25Media items per background task. 1 to 500.
Concurrency4Uploads at the same time, for the sizes of one media item. 1 to 10.
Multipart threshold16 MBBigger files upload in parts.
Part size16 MBThe size of each part.
Retry failed uploads5 triesHow many times an upload is tried. 1 to 20.
Outage threshold5Failures in a row before Offloft treats the provider as down. 2 to 50.
Upload lease900 secondsHow long one worker may hold an upload before another may take over. 300 to 7,200.
Keep activity for90 daysHow long the activity log is kept. 1 to 3,650.
Debug loggingOffTurns itself off after 24 hours. Records requests to your storage, never keys or passwords.
Remove all Offloft data on uninstallOffAlso deletes its settings, connection, file records, activity and scheduled tasks. Your files stay.

Set in code

  • OFFLOFT_DELIVERY_DOMAIN sets the delivery domain in wp-config.php.
  • OFFLOFT_ENCRYPTION_KEY sets the key used to encrypt saved access keys.
  • The offloft/capability filter sets who can manage Offloft.

Type to search.