G33ki Cloud Storage For Media Library

Description

G33ki Cloud Storage For Media Library is the ultimate solution to offload media library assets, including images, videos, and documents, to leading cloud storage providers. By choosing to move media library to cloud, you significantly improve your website’s performance, reduce server hosting costs, and leverage global CDN delivery — all with zero manual effort and no external dependencies.

Whether you’re looking to offload WordPress media to Amazon S3, or seeking a cost-effective way to store files on DigitalOcean Spaces, this plugin handles it all automatically.

Key Features

Multi-Cloud Provider Support

  • Amazon S3 — Industry-leading object storage with global infrastructure
  • DigitalOcean Spaces — S3-compatible storage with predictable, affordable pricing
  • Google Cloud Storage — Enterprise-grade storage powered by Google’s network (via HMAC keys)

Automatic Media Synchronization

  • New uploads automatically copied to cloud storage in real-time
  • All image sizes and thumbnails synced automatically
  • Videos, PDFs, documents — all file types supported
  • Zero manual intervention required

Powerful Bulk Migration Tool

  • One-click migration for existing media libraries
  • Real-time progress tracking with detailed statistics
  • Batch processing for optimal performance
  • Auto-retry on connection timeouts (handles Cloudflare 524 errors)
  • Comprehensive error reporting

CDN & Performance Optimization

  • Seamless CloudFront and custom CDN integration
  • Full URL rewriting — post content, srcset, thumbnails, theme templates, headers, footers
  • Output buffer rewrites all frontend HTML — catches even hardcoded theme URLs
  • Smart re-link — detects files already in cloud, skips re-upload
  • Global content delivery for faster load times
  • Reduced server bandwidth and hosting costs

Built-in Repair & Diagnostic Tools

  • Fix Permissions — Scans all offloaded files and detects 403 AccessDenied errors. One-click fix sets public-read ACL or re-uploads with correct permissions. Essential after bulk operations or bucket policy changes.
  • Fix Thumbnails — Finds offloaded images where thumbnail sizes are missing from the cloud. Common after bulk offload interruptions or when WordPress generates new image sizes. Uploads missing thumbnails and stores their cloud URLs so all image sizes load correctly.
  • Fix URLs — Detects when your CDN URL, bucket, or region settings changed but stored media URLs still point to the old location. Bulk-updates all stored URLs to match current settings without re-uploading. Essential after migrating between providers or changing CDN configuration.

Each repair tool follows a Scan > Review > Fix workflow with real-time progress tracking.

Safety & Recovery

  • Restore local files — download cloud media back to server anytime
  • Deactivation safety warning when local files are missing
  • Secure credential storage
  • Built-in connection testing before going live

Zero Dependencies

  • No Composer required
  • No external SDKs or libraries needed
  • Works out of the box on any WordPress host
  • Uses WordPress built-in HTTP API with secure request signing

Admin Menu Pages

  • Settings — Configure provider, credentials, CDN, path prefix, local file removal
  • Bulk Offload — Migrate entire media library to cloud with progress tracking and auto-retry
  • Restore Local — Download cloud files back to server before deactivating
  • Fix Permissions — Scan for 403/404 errors and set public-read ACL
  • Fix Thumbnails — Find and upload missing thumbnail sizes to cloud
  • Fix URLs — Update stale URLs after CDN/bucket/region config changes

How It Works

  1. Configure Your Provider — Enter cloud storage credentials (access key, secret key, bucket, region)
  2. Test Connection — Verify settings with built-in connection tester
  3. Automatic Sync — All new uploads automatically copied to cloud storage
  4. Bulk Offload — Migrate existing media files with one-click bulk tool
  5. Serve from Cloud — Media URLs automatically rewritten to cloud/CDN URLs
  6. Diagnose & Fix — Use repair tools if any issues arise

Supported Cloud Providers

Amazon S3
The industry-standard object storage service with global reach, advanced features, and seamless CloudFront CDN integration.

DigitalOcean Spaces
S3-compatible storage with simple, predictable pricing and built-in CDN. Perfect for developers and growing businesses.

Google Cloud Storage
Powerful storage infrastructure from Google with multi-regional redundancy and edge caching capabilities. Uses HMAC keys for authentication.

Perfect For

  • High-Traffic Websites — Reduce server load and bandwidth costs
  • Photography & Portfolio Sites — Store and deliver large image libraries efficiently
  • E-commerce Stores — Offload product images and improve checkout speed
  • News & Magazine Sites — Handle extensive media archives with ease
  • Multi-Site Networks — Centralize media storage across multiple sites

SEO & Performance Benefits

  • Faster Page Load Times — Improve Core Web Vitals and SEO rankings
  • Global CDN Delivery — Serve content from locations closest to your visitors
  • Mobile Optimization — Faster image delivery for mobile users
  • Better Search Rankings — Google rewards faster websites
  • Reduced Bounce Rate — Keep visitors engaged with quick-loading pages

External services

This plugin connects to external cloud storage providers to automatically offload and serve your media files. Depending on your configuration, it relies on one of the following third-party services:

Amazon S3
Used to store and serve your media files globally.
Data sent: Your media files (images, videos, documents), filenames, and MIME types are sent securely to Amazon S3 whenever you upload a new file or use the bulk offload tool.
Terms of Use: AWS Service Terms
Privacy Policy: AWS Privacy Notice

DigitalOcean Spaces
Used to store and serve your media files globally.
Data sent: Your media files (images, videos, documents), filenames, and MIME types are sent securely to DigitalOcean whenever you upload a new file or use the bulk offload tool.
Terms of Use: DigitalOcean Terms of Service
Privacy Policy: DigitalOcean Privacy Policy

Google Cloud Storage
Used to store and serve your media files globally.
Data sent: Your media files (images, videos, documents), filenames, and MIME types are sent securely to Google Cloud Storage whenever you upload a new file or use the bulk offload tool.
Terms of Use: Google Cloud Terms
Privacy Policy: Google Cloud Privacy Notice

Privacy Policy

This plugin does not collect or store any personal data. All cloud storage credentials are stored in your WordPress database and are only used to communicate with your chosen cloud storage provider. No data is sent to third parties except your selected cloud provider.

Credits

Developed by Gunjan Jaswal

If you find this plugin helpful, please consider rating this plugin on WordPress.org or sharing with other WordPress users.

Installation

Automatic Installation

  1. Log in to your WordPress admin panel
  2. Navigate to Plugins > Add New
  3. Search for “G33ki Cloud Storage For Media Library” or “offload media library”
  4. Click “Install Now” and then “Activate”

Manual Installation

  1. Download the plugin ZIP file
  2. Log in to your WordPress admin panel
  3. Navigate to Plugins > Add New > Upload Plugin
  4. Choose the ZIP file and click “Install Now”
  5. Activate the plugin

No additional setup steps, libraries, or Composer required. The plugin works immediately after activation.

Configuration

  1. Navigate to G33ki Cloud > Settings in your WordPress admin
  2. Select your storage provider (Amazon S3, DigitalOcean Spaces, or Google Cloud Storage)
  3. Enter your credentials:
    • Access Key / Access Key ID
    • Secret Key / Secret Access Key
    • Bucket Name
    • Region
  4. (Optional) Configure CDN URL and path prefix
  5. Click “Test Connection” to verify your settings
  6. Click “Save Settings”

Google Cloud Storage Setup

For GCS, you need HMAC keys instead of a service account JSON file:

  1. Go to Google Cloud Console > Cloud Storage > Settings
  2. Click the “Interoperability” tab
  3. Create an HMAC key for your service account
  4. Use the Access Key and Secret as your credentials in the plugin

FAQ

Does this plugin require Composer or external libraries?

No! The plugin works completely standalone. It uses WordPress’s built-in HTTP API with AWS Signature V4 request signing. Just install, activate, and configure.

Does this plugin upload files directly to cloud storage?

Files are first uploaded to your WordPress server, then automatically copied to your cloud storage. The process is seamless and happens in the background.

What happens to my existing media files?

Existing media files are not automatically migrated. Use the Bulk Offload tool under G33ki Cloud > Bulk Offload to migrate existing files with one click.

Can I remove local files after uploading to cloud storage?

Yes! Enable the “Remove Local Files” option in settings. Files will be automatically deleted from your server after successful upload to cloud storage.

Will this work with my CDN (CloudFront, etc.)?

Absolutely! Enter your CDN URL (CloudFront, KeyCDN, BunnyCDN, etc.) in the “CDN URL” field, and all media will be served through your CDN.

What if I deactivate the plugin?

Before deactivating, go to G33ki Cloud > Restore Local to download all cloud-stored files back to your server. A warning notice on the Plugins page reminds you if local files are missing. After restoring, WordPress will serve media from your server as normal.

Some images show 403 AccessDenied errors after bulk offload. How do I fix this?

Go to G33ki Cloud > Fix Permissions. This tool scans all offloaded files and detects which ones are returning errors. Click “Fix All Broken Files” to set the correct public-read ACL on each file.

Some image sizes (thumbnails) are not loading from the cloud. How do I fix this?

Go to G33ki Cloud > Fix Thumbnails. This tool scans all offloaded attachments and finds which thumbnail sizes are missing from the cloud. Click “Fix Missing Thumbnails” to upload them.

I changed my CDN URL / bucket / region and now images are broken. How do I fix this?

Go to G33ki Cloud > Fix URLs. This tool detects when stored URLs don’t match your current settings. Click “Fix All Mismatched URLs” to update them — no re-uploading needed.

The bulk offload stops or times out midway. What do I do?

The plugin has built-in auto-retry (up to 5 attempts per batch). If it still fails, just click “Start Bulk Offload” again — it picks up where it left off since already-offloaded files are automatically skipped.

Does this support video and document files?

Yes! The plugin supports all file types that WordPress allows in the media library, including images, videos, documents, audio files, and archives.

Is this compatible with page builders?

Yes, the plugin works seamlessly with Elementor, Beaver Builder, Divi, WPBakery, Gutenberg, Oxygen, and more.

Can I use this with WooCommerce?

Yes! The plugin works perfectly with WooCommerce product images, galleries, and downloadable products.

Does this work with WordPress Multisite?

Yes, the plugin is multisite compatible. You can configure different cloud storage settings for each site in your network.

How much does cloud storage cost?

Cloud storage is very affordable:

  • Amazon S3: ~$0.023/GB/month + data transfer
  • DigitalOcean Spaces: $5/month for 250GB + 1TB transfer
  • Google Cloud Storage: ~$0.020/GB/month + data transfer

Most small to medium websites pay less than $5-10/month.

Can I migrate between cloud providers?

Yes, you can change providers at any time. Update your settings, use Fix URLs to update stored URLs, and use the bulk offload tool to re-upload media to the new provider.

Is my data secure?

Yes! All credentials are stored securely in your WordPress database. Data is transmitted over HTTPS. AWS Signature V4 request signing ensures credentials are never sent in plain text. All admin actions require manage_options capability.

How do I get support?

  • Visit the WordPress.org support forum
  • Contact the developer: hello@gunjanjaswal.me
  • Report bugs on GitHub

Reviews

There are no reviews for this plugin.

Contributors & Developers

“G33ki Cloud Storage For Media Library” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.2.2

  • Rebranding: Renamed to G33ki Cloud Storage For Media Library
  • SEO: Improved description for better search visibility on “offload media library” and “move media to cloud” keywords
  • Cleanup: Removed Buy Me a Coffee links

1.2.1

  • Fix: Removed inline script tag from fix-urls.php template to adhere to WP enqueuing guidelines
  • Fix: Replaced ob_start() full-page buffering with wp_template_enhancement_output_buffer
  • Docs: Added External Services declaration block to document S3/DO/GCS usage

1.2.0

  • New: Full-page output buffer URL rewriting — catches theme-hardcoded image URLs in headers, footers, and templates
  • New: Handles http/https URL variations and relative /wp-content/uploads/ paths
  • New: Filters for post_thumbnail_html, widget_text, custom_logo, wp_get_attachment_image, header_image_tag
  • Fix: Images in theme templates not rewriting for non-logged-in users

1.1.0

  • New: Fix Permissions tool — scan and repair 403 AccessDenied cloud files
  • New: Fix Thumbnails tool — find and upload missing thumbnail sizes to cloud
  • New: Fix URLs tool — bulk-update stale URLs after CDN/bucket/region changes
  • New: Auto-retry on connection timeouts (up to 5 retries per batch)
  • New: Smart re-link — detects existing cloud files and skips re-upload
  • New: Set public-read ACL when re-linking existing cloud files
  • Fix: Bulk offload offset logic causing premature “completed” status
  • Fix: Batch size reduced to avoid Cloudflare 524 timeout errors
  • Fix: Success message no longer persists after page reload

1.0.0

  • Initial release
  • Support for Amazon S3, DigitalOcean Spaces, and Google Cloud Storage
  • No external SDK dependencies — uses built-in HTTP API with request signing
  • Automatic upload synchronization for new media
  • Bulk offload tool for existing media with batch processing
  • CDN integration support (CloudFront, custom domains)
  • Built-in connection testing
  • Optional local file removal after cloud upload
  • Restore local files tool — download cloud media back to server
  • Deactivation safety warning when local files are missing
  • Custom path prefix support