Skip to main content
Agency Program Get 2× more leads and save 50% on hosting. Built for agencies ready to grow. Book a call
WP-Stateless – Google Cloud Storage icon

WP-Stateless – Google Cloud Storage

v4.1.3
by Andy Potanin · 3.9 (51 reviews)

Upload and serve your WordPress media files from Google Cloud Storage.

4K+ active installs Updated Mar 12, 2025 Tested to 6.7.2 Requires PHP 8.0
Try Demo Download
Pre-installed Ready in ~10s No card
WP-Stateless – Google Cloud Storage

About WP-Stateless – Google Cloud Storage

The WP-Stateless plugin allows you to upload and serve your WordPress media from Google Cloud Storage, reducing latency and improving page speed. It also offers various modes and features to customize your media storage and delivery. Plus, Google is offering a $300 credit to get started with Google Cloud.

Screenshots

WP-Stateless – Google Cloud Storage screenshot
WP-Stateless – Google Cloud Storage screenshot
WP-Stateless – Google Cloud Storage screenshot
WP-Stateless – Google Cloud Storage screenshot
WP-Stateless – Google Cloud Storage screenshot
WP-Stateless – Google Cloud Storage screenshot
WP-Stateless – Google Cloud Storage screenshot

Changelog

4.1.3

  • COMPATIBILITY – PolyLang Compatibility replaced with WP-Stateless – Polylang Pro Addon.
  • ENHANCEMENT – updated wpmetabox/meta-box library from from 5.10.1 to 5.10.7.
  • ENHANCEMENT – updated Meta Box Tabs library from 1.1.18 to 1.2.0.
  • ENHANCEMENT – updated firebase/php-jwt library from from 6.10.1 to 6.10.2.
  • ENHANCEMENT – updated wpmetabox/meta-box library from from 5.10.1 to 5.10.2.
  • ENHANCEMENT – Updated Client library for Google APIs from 2.17.0 to 2.18.2.
  • FIX – apply Cache Control setting to all files (previously applied only to images).

4.1.2

4.1.1

  • FIX – cache issues during Data Optimization.

4.1.0

  • NEW – move compatibilities files from wp_sm_sync to wp_stateless_files table with extended information.
  • COMPATIBILITY – WooCommerce Compatibility replaced with WP-Stateless – WooCommerce Addon.
  • COMPATIBILITY – Gravity Forms Compatibility replaced with WP-Stateless – Gravity Forms Addon.
  • COMPATIBILITY – Gravity Forms Signature Compatibility replaced with WP-Stateless – Gravity Forms Signature Addon.
  • COMPATIBILITY – Divi Theme Compatibility replaced with WP-Stateless – Divi Theme Addon.
  • COMPATIBILITY – SiteOrigin CSS Compatibility replaced with WP-Stateless – SiteOrigin CSS Addon.
  • ENHANCEMENT – CLI command wp stateless migrate supports auto parameter to run all required Data Optimizations automatically.
  • ENHANCEMENT – Updated Client library for Google APIs from 2.15.1 to 2.17.0.
  • ENHANCEMENT – updated firebase/php-jwt library from from 6.9.0 to 6.10.1.
  • ENHANCEMENT – updated wpmetabox/meta-box library from from 5.8.2 to 5.10.1.
  • ENHANCEMENT – updated deliciousbrains/wp-background-processing library from from 1.1.1 to 1.3.1.
  • ENHANCEMENT – updated composer/installers library from from 1.12.1 to 2.3.0.
  • ENHANCEMENT – updated Meta Box Tabs library from 1.1.17 to 1.1.18.
  • ENHANCEMENT – action sm:sync::addFile format changed, now it passes media object instead of file name.
  • ENHANCEMENT – for installed Addons replace Download action with Activate.
  • ENHANCEMENT – count compatibility files from the DB instead of listing actual files to increase performance.
  • FIX – CLI command wp stateless migrate supports --yes parameter to skip confirmation.
  • FIX – CLI command wp stateless migrate correctly works with --progress parameter in multisite.
  • FIX – fixed synchronization for Compatibility files in Stateless Mode.
  • FIX – CLI command wp stateless upgrade fixed when running with --b switch.
  • FIX – fixed SiteOrigin Widgets Bundle Compatibility in Stateless mode.
  • FIX – fixed WPForms Compatibility in Stateless mode.
  • FIX – limit index size for compatibility with different DB engines 757.
  • FIX – correctly disable Cache-Busting setting for Ephemeral Mode 758, credits @Jessedev1.
  • FIX – Data Optimization UI adjustments.

4.0.4

  • ENHANCEMENT – display success message after copying Status Info.
  • FIX – Settings page does not open or slow when there is big amount of attachments.
  • FIX – in multisite network, removing custom tables properly when deleting site.
  • FIX – skip setting ACL in Stateless mode and during Sync for the buckets with Uniform access, support WP_STATELESS_SKIP_ACL_SET constant #712.

4.0.3

  • NEW – added Info section to the Status tab on the Settings page, which contains the system info and the ability to copy report to clipboard.
  • ENHANCEMENT – added Documentation link on the Plugins page.
  • ENHANCEMENT – added Addons link on the Plugins page.
  • ENHANCEMENT – added Documentation link on the Settings page.
  • FIX – fixed Settings shortcut on the Plugins page.
  • FIX – in multisite network, do not show Data Optimization on the Network Admin Page.
  • FIX – properly set Content Disposition fields for media objects.
  • FIX – properly use Cache Control setting for media objects.
  • FIX – fixed Creation of dynamic property PHP deprecation notice.
  • FIX – fixed Cannot use ::class with dynamic class name PHP warning.
  • FIX – avoid PHP warning when unable to get file path in Stateless mode 728.
  • FIX – fixed links to the constants documentation.

4.0.2

  • FIX – in multisite network, deleting site can potentially remove WP-Stateless tables from another site.
  • COMPATIBILITY – Gravity Forms Compatibility updated for the newest Gravity Forms version.

4.0.1

  • FIX – improvements to Data Optimization process.
  • FIX – Data Optimization fixed for multisite environment.

4.0.0

  • NEW – use custom database tables to store GCS file data. This increases plugin performance and will be used for future improvements.
  • NEW – added filter wp_stateless_get_file, retrieves the GCS file data, should be used instead of getting sm_cloud postmeta directly.
  • NEW – added filter wp_stateless_get_file_sizes, retrieves the GCS file data for image sizes, should be used instead of getting sm_cloud postmeta directly.
  • NEW – added filter wp_stateless_get_file_meta, retrieves all GCS file meta data, should be used instead of getting sm_cloud postmeta directly.
  • NEW – added filter wp_stateless_get_file_meta_value, retrieves the GCS file meta data by meta_key, should be used instead of getting sm_cloud postmeta directly.
  • NEW – added filter wp_stateless_get_setting_... which allows to override any WP-Stateless setting.
  • NEW – added setting “Send Status Emails” allowing to change email for WP-Stateless notifications.
  • NEW – added setting “Use Post Meta” allowing to switch back to using postmeta instead of custom DB tables. Can be used in case of issues after upgrading to 4.0.0.
  • NEW – added new Settings tab Addons, which contains the list of WP-Stateless Addons, which replace Compatibilities.
  • NEW – added new Settings tab Status, which contains status and health information related to Google Cloud Storage and WP-Stateless.
  • NEW – CLI command wp stateless migrate to list and operate data optimizations.
  • NEW – configuration constant WP_STATELESS_POSTMETA allows to read the GCS file data from postmeta instead of the new custom database tables.
  • NEW – configuration constant WP_STATELESS_BATCH_HEALTHCHECK_INTERVAL defines an interval in minutes for periodical health checks of a batch background process (like data optimization).
  • COMPATIBILITY – BuddyBoss Compatibility replaced with WP-Stateless – BuddyBoss Platform Addon.
  • COMPATIBILITY – Elementor Compatibility replaced with WP-Stateless – Elementor Website Builder Addon.
  • COMPATIBILITY – Gravity Form Compatibility does not support older version of Gravity Forms (< 2.3).
  • ENHANCEMENT – Allow dismissing notices in Admin Panel only for logged in users.
  • ENHANCEMENT – Updated wp-background-processing library from from 1.0.2 to 1.1.1.
  • ENHANCEMENT – Updated phpseclib 3.0.34 to 3.0.37.
  • FIX – proper use of infinite timeout in set_time_limit function to avoid issues with PHP 8.1 and above #704.

3.4.1

  • FIX – improve security while processing AJAX requests in Admin Panel

3.4.0

  • ENHANCEMENT – removed udx/lib-settings package dependency for security reasons.
  • ENHANCEMENT – removed udx/lib-utility package dependency for security reasons.
  • ENHANCEMENT – refactored Settings admin page to remove Angular dependency.
  • ENHANCEMENT – including Software Bill of Materials (SBOM) to GitHub release.
  • FIX – updated package dependencies for Google Client Library for security reasons.
  • FIX – replaced utf8_encode with mb_convert_encoding to support PHP 8.2 and above #678.
  • FIX – Fatal Error in Stateless mode if GCP access credentials are wrong #693.
  • COMPATIBILITY – preventing PHP warnings while working with WooCommerce version 8.4.0 and above 696.
  • COMPATIBILITY – avoiding conflicts between builtin compatibilities and WP-Stateless Addon plugins.

3.3.0

  • NEW – Added new filter wp_stateless_attachment_url. Allows to customize attachment URL after WP-Stateless generates it based on it’s internal conditions.
  • FIX – Stateless mode Incompatible with Media Uploader in Media Library Grid mode #675.
  • FIX – Prevent duplicating messages in Admin Panel.
  • COMPATIBILITY – Dynamic Image Support is now part of the core.
  • COMPATIBILITY – Google App Engine is now part of the core. Automatically enables Stateless mode when Google App Engine detected. Can be disabled using WP_STATELESS_COMPATIBILITY_GAE constant.
  • COMPATIBILITY – Removed compatibility with “Advanced Custom Fields: Image Crop Add-on”, because plugin is deprecated.
  • COMPATIBILITY – Removed compatibility with “VidoRev” plugin.
  • COMPATIBILITY – Removed compatibility with “WP Retina 2x” plugin.
  • ENHANCEMENT – Updated Client library for Google APIs from 2.15.0 to 2.15.1.
  • ENHANCEMENT – Updated Meta Box library from 5.6.3 to 5.8.2.
  • ENHANCEMENT – Updated Meta Box Tabs to version 1.1.17.
  • ENHANCEMENT – Updated PHP JWT library from 6.6.0 to 6.9.0.

3.2.5

  • FIX – Folder setting does not allow custom structure #608.
  • FIX – Stateless mode Incompatible with Inline Uploader #675.
  • FIX – html tags incorrectly applied in notice #680.
  • ENHANCEMENT – Add WP_STATELESS_SKIP_ACL_SET for skip ACL set for GCS #625.
  • COMPATIBILITY – Add support for The Events Calendar #599.

3.2.4

  • FIX – Website unresponsive after Upgrade #669.

3.2.3

  • WP-Stateless 3.2.3 requires PHP 8.0+. Recently, Google updated the official Google API PHP Client Library used by WP-Stateless to resolve security issues. This updated library requires PHP 8.0.
  • ENHANCEMENT – Updated Client library for Google APIs.
  • ENHANCEMENT – Updated Monolog library to version 3.
  • ENHANCEMENT – Updated JWT library.
  • FIX – Fixed vulnerability issues.
  • FIX – Fixed an errors and warnings on PHP 8.1.
  • FIX – Fixed an error that occured when WP_STATELESS_MEDIA_UPLOAD_CHUNK_SIZE is set.

3.2.2

  • FIX – Folder setting can’t be saved from the settings page #639.

3.2.1

  • FIX – Updated requirments.
  • FIX – WP-Stateless 3.2.0 doesn’t upload docs, only images #638.

3.2.0

  • Before upgrading to WP-Stateless 3.2.0, please, make sure you tested it on your development environment. It may have breaking changes.
  • ENHANCEMENT – Upgraded wpmetabox library.
  • ENHANCEMENT – Updated Client library for Google APIs.
  • ENHANCEMENT – Updated Guzzle library to version 7.
  • ENHANCEMENT – Updated JWT library.
  • ENHANCEMENT – Updated license functionality, removed update checker.
  • FIX – Fixed vulnerability issues.
  • FIX – Fixed erros and warnings on PHP 8.
  • FIX – problem after the upgrade #628.
  • FIX – image_downsize() PHP8 Required parameter $id follows optional parameter $false #619.

3.1.1

  • ENHANCEMENT – Notification for the administrator about finished synchronization. GitHub issue #576.
  • FIX – Fixed an issue with PDF thumbnails. GitHub issue #577.
  • FIX – Fixed an issue with synchronization in Stateless mode. GitHub issue #575.
  • COMPATIBILITY – Changed the way compatibility files are stored on Multisite. GitHub issue #588.

3.1.0

  • NEW – Completely rewritten the synchronization tool. GitHub issue #523.
  • NEW – New configuration constant WP_STATELESS_SYNC_MAX_BATCH_SIZE. Sets the maximum size of a background sync batch of items to be saved in a single row in the database. More details.
  • NEW – New configuration constant WP_STATELESS_SYNC_LOG. Sets a path to a log file where to output logging information during the background sync. More details.
  • NEW – New configuration constant WP_STATELESS_SYNC_HEALTHCHECK_INTERVAL. Defines an interval in minutes for a cron task that periodically checks the health of a particular background sync process. More details.
  • FIX – Fixed an issue when original files were not deleted from the server in the Ephemeral mode. GitHub issue #484.
  • FIX – Fixed an incorrect behavior of image srcset attribute in the Backup mode. GitHub issue #558.
  • COMPATIBILITY – Litespeed Cache – Fixed an incorrect upload folder determination. GitHub issue #527.

3.0.4

  • FIX – Fixed inability to use dashes in the upload folder name. GitHub issue #565.
  • COMPATIBILITY – Elementor – Fixed wrong upload directory. GitHub issue #560.

3.0.3

  • FIX – Fixed an incorrect file URL in Stateless mode on Edit Media screen. GitHub issue #544.

3.0.2

  • FIX – Refactored the way files are being uploaded to GCS when WP_STATELESS_MEDIA_UPLOAD_CHUNK_SIZE constant is defined. GitHub issue #553.
  • FIX – Fixed the process of upgrading to 3.0 for multisite installations. GitHub issue #549.

3.0.1

  • FIX – Fatal Error in Stateless mode. GitHub issue #546.

3.0

  • Before upgrading to WP-Stateless 3.0, please, make sure you tested it on your development environment. It may have breaking changes.
  • NEW – Setup assistant rewrite. GitHub issue #477.
  • NEW – Recreate attachment metabox panel using metabox.io. GitHub issue #470.
  • NEW – Updated the Stateless mode to not use local storage at all. Current Stateless mode setting mapped to new Ephemeral mode. GitHub issue #482.
  • NEW – Files are now uploaded to GCS in chunks and chunk size will be determined based on free memory available. GitHub issue #478.
  • NEW – File upload chunk size can be controlled with WP_STATELESS_MEDIA_UPLOAD_CHUNK_SIZE constant. GitHub issue #478.
  • FIX – Changed the default value for the Cache-Busting setting. GitHub issue #361.
  • FIX – Fixed network override of Cache-Busting. GitHub issue #468.
  • FIX – Fixed “Passing glue string after array is deprecated.”. GitHub issue #444.
  • FIX – Fixed Compatibility default value in multisite. GitHub issue #464.
  • FIX – Fixed multisite wrong GCS path. GitHub issue #407.
  • FIX – Don’t check for Google Cloud Storage connectivity in stateless mode unless uploading. GitHub issue #442.
  • COMPATIBILITY – Google App Engine – Added new compatibility support for Google App Engine. #486
  • COMPATIBILITY – Elementor – Fixed wrong MIME type for CSS files. GitHub issue #395.
  • COMPATIBILITY – Polylang – Fixed missing metadata issue. GitHub issue #378.
  • COMPATIBILITY – EWWW – Fixed mime type for WEBP images. GitHub issue #371.
  • COMPATIBILITY – Simple Local Avatars – Added new compatibility support for Simple Local Avatars. GitHub issue #297.
  • COMPATIBILITY – BuddyPress – Fixed BuddyPress compatibility. GitHub issue #275.
  • COMPATIBILITY – Divi – Fixed Divi cache issue. GitHub issue #430.
  • COMPATIBILITY – Gravity Forms – add compatibility for Gravity Forms Signature Add-On. #501.
  • COMPATIBILITY – Litespeed – Fixed fatal error and warnings. #491.
  • COMPATIBILITY – Imagify – Added support for webp. #403.
  • ENHANCEMENT – Update Client library for Google APIs. #446.
  • ENHANCEMENT – Wildcards for bucket folder settings. GitHub issue #149.
  • ENHANCEMENT – Better CLI integration. GitHub issue #447, #450 and #451.
  • ENHANCEMENT – Sync media according to new Bucket Folder settings. GitHub issue #449.
  • ENHANCEMENT – Moved Bucket Folder setting in the File URL section. GitHub issue #463.
  • ENHANCEMENT – Hide Regenerate and Sync with GCS when the mode is Disabled. GitHub issue #440.
  • ENHANCEMENT – New endpoint for the Google Cloud Storage JSON API. GitHub issue #384.
  • ENHANCEMENT – Renamed current Stateless mode to Ephemeral. GitHub issue #481.

2.3.2

  • FIX – Fixed video file doesn’t get deleted from the server in Stateless mode. GitHub issue #418.
  • FIX – Fixed file size doesn’t show under attachment details in Stateless mode. GitHub issue #413.
  • FIX – Fixed Cache-Busting feature works even if the Mode is Disabled. GitHub issue #405.
  • COMPATIBILITY – Fixed Gravity Form Post Image didn’t include Bucket Folder. GitHub issue #421.
  • COMPATIBILITY – Fixed Divi Builder Export. GitHub issue #420.
  • COMPATIBILITY – Fixed BuddyBoss pages breaking after updating to 2.3.0. GitHub issue #417.

2.3.1

  • Fix – Fixed fatal error, undefined function is_wp_version_compatible. GitHub issue #414.

2.3.0

  • FIX – Fixed problem with WordPress 5.3. GitHub issue #406.
  • FIX – Fixed problem with the Cache Busting feature. GitHub issue #377.
  • COMPATIBILITY – Added compatibility support for WP Retina 2x pro. GitHub issue #380.
  • COMPATIBILITY – Enhanced compatibility support for LiteSpeed Cache. GitHub issue #365.
  • COMPATIBILITY – Enhanced compatibility support for ShortPixel Image Optimizer. GitHub issue #364, #398.
  • COMPATIBILITY – Fixed Gravity Form export. GitHub issue #408.
  • ENHANCEMENT – Improved upon add_media function for better compatibility support. GitHub issue #382.

2.2.7

  • FIX – WP-Smush compatibility enhanced. GitHub Issue #366.
  • FIX – Fixed multisite installation support. GitHub Issue #370.
  • FIX – Fixed settings UI problems related to Cache-Busting option. GitHub Issue #373.
  • FIX – Other minor fixes.

2.2.6

  • FIX – Multisite Network Settings page fixed. GitHub Issue #369.
  • FIX – Fixed incorrect Compatibilities behavior when Bucket Folder is set. GitHub Issue #368.
  • FIX – Other minor fixes.

2.2.5

  • NEW – Added ability to start sync process from specific Attachment ID. GitHub Issue #360.
  • COMPATIBILITY – Added compatibility support for LiteSpeed Cache plugin. Especially to support optimized .webp images. GitHub Issue #357.
  • FIX – Other minor fixes.

Earlier versions

Please refer to the separate changelog.txt file.

Try other plugins

Yoast SEO icon

Yoast SEO

4.8 · 10M+ installs

Improve your WordPress SEO: Write better content and have a fully optimized WordPress site using the Yoast SEO…

LiteSpeed Cache icon

LiteSpeed Cache

4.8 · 7M+ installs

All-in-one unbeatable acceleration & PageSpeed improvement: caching, image/CSS/JS optimization...

WooCommerce icon

WooCommerce

4.5 · 7M+ installs

Everything you need to launch an online store in days and keep it growing for years. From your…