How to set Offload Delay?

Hi @yajwp
Thanks for the feedback!

You can find your answer by reading this guide: https://wpfitter.com/blog/implementing-smart-retention-policies-with-advanced-media-offloader/

@yajwp

Could you please share your code here with us? For how long did you delayed the offloading?

Do you have a specific purpose to delay the offload?

Hi @yajwp

After uploading a file to your Media Library, the file gets immediately offloaded to the cloud storage. But you can delay the offloading process by using the following code and adding it to your theme / child-theme functions.php:

/**
 * Prevent offloading of newly uploaded attachments (younger than 5 minutes).
 * @param bool $should_offload Current decision.
 * @param int $attachment_id Attachment ID.
 * @param array|null $metadata Attachment metadata when available.
 * @return bool False to skip offloading.
 */
function wpfitter_prevent_recent_offload($should_offload, $attachment_id, $metadata = null)
{
    try {
        $post = get_post($attachment_id);
        if (!$post) {
            return $should_offload;
        }
        
        // Compare upload time (GMT) against now (GMT)
        $created_gmt = get_post_time('U', true, $post);
        $now_gmt = current_time('timestamp', true);
        
        if (is_numeric($created_gmt) && ($now_gmt - (int) $created_gmt) < (30 * MINUTE_IN_SECONDS)) {
            return false;
        }
        
        return $should_offload;
    } catch (\Throwable $e) {
        // Fail open to avoid interrupting uploads/offload flow
        return $should_offload;
    }
}
add_filter('advmo_should_offload_attachment', 'wpfitter_prevent_recent_offload', 10, 3);

Note:
Retention policies like “Retain Local Files” or “Full Cloud Policy” doesn’t delay the offloading process. They are rules to define if a file should be deleted completely (Full Cloud Migration) from the local server after a successful offload or it should keep them on the local server and do not delete anything (Retain Local Files).