Troubleshooting & FAQ

1. AWS S3 "403 Access Denied" Error

If you receive an Access Denied or 403 Forbidden error when testing S3 connectivity:

• Check IAM Policy Resource ARN: Verify your IAM policy specifies both arn:aws:s3:::bucket-name (for bucket-level actions like ListBucket) and arn:aws:s3:::bucket-name/* (for object-level actions like PutObject).
• Check AWS Region: S3 buckets are region-specific. Ensure the region selected in Clockwork Offloader matches the physical region of your bucket (e.g. us-east-2).
• Check Object Ownership: If public read ACLs are blocked by AWS default security, make sure you are either serving files through CloudFront with Origin Access Control (OAC) or have enabled Object Ownership with ACLs enabled.

2. SVGs or Web Fonts Blocked by CORS

If browser consoles report Cross-Origin Request Blocked: The Same Origin Policy disallows reading the remote resource:

Ensure your S3 bucket permissions include a CORS rule allowing your WordPress domain:

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "HEAD"],
    "AllowedOrigins": ["https://yourdomain.com", "https://*.yourdomain.com"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 86400
  }
]

3. Large Batch Offload Timeouts in Web Browser

If your media library has more than 5,000 files, running bulk offloads through a web browser can hit PHP max_execution_time or server gateway timeouts (e.g. Nginx 504 Gateway Time-out).

4. Migrating from Legacy Offloading Plugins

Switching to Clockwork Offloader Pro is seamless:

1. Clockwork Offloader recognizes standard WordPress attachment metadata.
2. If you already have media stored in an S3 bucket in standard WordPress folder hierarchy (uploads/YYYY/MM/filename.jpg), simply enter your existing bucket and CloudFront domain into Clockwork Offloader.
3. Run wp clockwork-offloader verify --all-sites to map your attachments without re-uploading duplicate assets.
4. Deactivate the legacy plugin. Clockwork Offloader will take over URL rewriting immediately with zero downtime.

5. Need Direct Engineering Support?

Pro license holders receive priority developer support. Visit our License Portal or open a ticket directly with our engineering team at [email protected].