PHPackages                             wpcloud/wp-stateless - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. wpcloud/wp-stateless

ActiveWordpress-plugin[Utility &amp; Helpers](/categories/utility)

wpcloud/wp-stateless
====================

WP-Stateless WordPress plugin

4.4.1(3mo ago)27060969[64 issues](https://github.com/wpCloud/wp-stateless/issues)[12 PRs](https://github.com/wpCloud/wp-stateless/pulls)PHPPHP &gt;=7.4CI passing

Since Dec 14Pushed 3mo ago20 watchersCompare

[ Source](https://github.com/wpCloud/wp-stateless)[ Packagist](https://packagist.org/packages/wpcloud/wp-stateless)[ Docs](https://udx.io)[ RSS](/packages/wpcloud-wp-stateless/feed)WikiDiscussions latest Synced 3d ago

READMEChangelog (10)Dependencies (8)Versions (122)Used By (0)Security (1)

WordPress Stateless Media Plugin
================================

[](#wordpress-stateless-media-plugin)

Description
-----------

[](#description)

Upload and serve your WordPress media from Google Cloud Storage (GCS) with the WP-Stateless plugin. In as little as two minutes, you will be benefiting from serving your media from Google Cloud's distributed servers.

New to Google Cloud? Google is offering you a [$300 credit](https://console.cloud.google.com/freetrial?referralId=e1c28cf728ff49b38d4eb5add3f5bfc8) to get you started.

### Benefits

[](#benefits)

- Store and deliver media files on Google Cloud Storage instead of your server.
- Google Cloud Storage is geo-redundant, meaning your media is delivered by the closest server - reducing latency and improving page speed.
- Scale your WordPress website across multiple servers without the need for synchronizing media files.
- Native integration between Google Cloud Storage and WordPress.
- $300 free trial from Google Cloud. Nice!

### Modes

[](#modes)

- Backup - Upload media files to Google Storage and serve local file URLs.
- CDN - Copy media files to Google Storage and serve them directly from there.
- Ephemeral - Store and serve media files with Google Cloud Storage only. Media files are not stored locally, but local storage is used temporarily for processing and is required for certain compatibilities.
- Stateless - Store and serve media files with Google Cloud Storage only. Media files are not stored locally.

### Features

[](#features)

- Setup assistant makes getting started fast and easy.
- No need to manually create service accounts or buckets - handled automatically.
- Settings panel provides you with further GCS configuration and file URL customization.
- Mask the default GCS URL with your own custom domain.
- Automatically replace hardcoded media URLs with GCS equivalents in post editor and meta.
- Batch image thumbnail regeneration.
- Synchronization tools for uploading existing files and images.
- All settings supported with wp-config constants and network setting overrides.
- Multiple modes: Backup, CDN, Ephemeral, Stateless.
- All files served in HTTPS mode.
- Serverless platform compatible, including Google App Engine.
- Multisite compatible.

### Addons

[](#addons)

- [Elementor Website Builder Addon](https://wordpress.org/plugins/wp-stateless-elementor-website-builder-addon/)
- [Gravity Forms Addon](https://wordpress.org/plugins/wp-stateless-gravity-forms-addon/)
- [Gravity Forms Signature Addon](https://wordpress.org/plugins/wp-stateless-gravity-forms-signature-addon/)
- [WPForms Addon](https://wordpress.org/plugins/wp-stateless-wpforms-addon/)
- [WooCommerce Addon](https://wordpress.org/plugins/wp-stateless-woocommerce-addon/)
- [Easy Digital Downloads Addon](https://wordpress.org/plugins/wp-stateless-easy-digital-downloads-addon/)
- [LiteSpeed Cache Addon](https://wordpress.org/plugins/wp-stateless-litespeed-cache-addon/)
- [Divi Theme Addon](https://wordpress.org/plugins/wp-stateless-divi-theme-addon/)
- [SiteOrigin CSS Addon](https://wordpress.org/plugins/wp-stateless-siteorigin-css-addon/)
- [SiteOrigin Widgets Bundle Addon](https://wordpress.org/plugins/wp-stateless-siteorigin-widgets-bundle-addon/)
- [BuddyPress Addon](https://wordpress.org/plugin/wp-stateless-buddypress-addon/)
- [BuddyBoss Platform Addon](https://wordpress.org/plugins/wp-stateless-buddyboss-platform-addon/)
- [Polylang Pro Addon](https://wordpress.org/plugins/wp-stateless-polylang-pro-addon/)
- [Simple Local Avatars](https://wordpress.org/plugins/wp-stateless-simple-local-avatars-addon/)

### Support, Feedback, &amp; Contribute

[](#support-feedback--contribute)

We welcome community involvement via the [GitHub repository](https://github.com/udx/wp-stateless).

### Custom Development

[](#custom-development)

Looking for a unique feature for your next project? [Hire us!](https://udx.io/)

Installation
------------

[](#installation)

1. Search, install, and activate the *WP-Stateless* plugin via your WordPress dashboard.
2. Begin WP-Stateless setup assistant at *Media &gt; Stateless Setup* and click "Get Started Now."
3. Click "Google Login" and sign in with your Google account.
4. Set a Google Cloud Project, Google Cloud Storage Bucket, and Google Cloud Billing Account and click "Continue."
5. Installation and setup are now complete. Visit *Media &gt; Stateless Settings* for more options.

For a more detailed installation and setup walkthrough, please see the [manual setup instructions on Github](https://stateless.udx.io/setup/).

Frequently Asked Questions
--------------------------

[](#frequently-asked-questions)

### What are the minimum server requirements for this plugin?

[](#what-are-the-minimum-server-requirements-for-this-plugin)

Beyond the [official WordPress minimum requirements](https://codex.wordpress.org/Template:Server_requirements), WP-Stateless requires a minimum PHP version of 8.0 or higher and OpenSSL to be enabled.

### What wp-config constants are supported?

[](#what-wp-config-constants-are-supported)

For a complete list of supported wp-config constants, please consult the [GitHub documentation](https://stateless.udx.io/docs/constants/).

### How do I manually generate the Service Account JSON?

[](#how-do-i-manually-generate-the-service-account-json)

The WP-Stateless setup assistant will create the Service Account JSON automatically for you, but you can follow these steps if you choose to create it manually.

1. Visit Google Cloud Console, and go to *IAM &amp; Admin &gt; Service accounts*.
2. Click *Create Service Account* and name it *wp-stateless*.
3. Set the role to *Storage &gt; Storage Admin*.
4. Check *Furnish a new private key* and select *JSON* as the key type.
5. Open the JSON file and copy the contents into the *Service Account JSON* textarea within the WP-Stateless settings panel.

### Where can I submit feature requests or bug reports?

[](#where-can-i-submit-feature-requests-or-bug-reports)

We encourage community feedback and discussion through issues on the [GitHub repository](https://github.com/udx/wp-stateless/issues).

### Can I test new features before they are released?

[](#can-i-test-new-features-before-they-are-released)

To ensure new releases cause as little disruption as possible, we rely on a number of early adopters who assist us by testing out new features before they are released. [Please contact us](https://udx.io/) if you are interested in becoming an early adopter.

### Who maintains this plugin?

[](#who-maintains-this-plugin)

[UDX](https://udx.io/) maintains this plugin by continuing development through its own staff, reviewing pull requests, testing, and steering the overall release schedule. UDX is located in Durham, North Carolina, and provides WordPress engineering and hosting services to clients throughout the United States.

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance74

Regular maintenance activity

Popularity34

Limited adoption so far

Community30

Small or concentrated contributor base

Maturity80

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~36 days

Recently: every ~23 days

Total

103

Last Release

116d ago

Major Versions

1.9.2 → v2.0.0-rc12017-08-15

2.4.0-RC.4 → 3.02020-09-09

3.4.1 → 4.0.0-RC-12024-03-28

PHP version history (5 changes)1.5PHP &gt;=5.3

1.7.2PHP &gt;=5.5

1.7.3PHP &gt;=5.4

3.0PHP &gt;=5.6.20

4.2.1PHP &gt;=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/26fb1afd034b43a7fe204dfc667c143ce7fbda46be477ba7212cf753cd784706?d=identicon)[andy.potanin](/maintainers/andy.potanin)

---

Top Contributors

[![antonkorotkov](https://avatars.githubusercontent.com/u/2276882?v=4)](https://github.com/antonkorotkov "antonkorotkov (247 commits)")[![alimuzzaman](https://avatars.githubusercontent.com/u/6744156?v=4)](https://github.com/alimuzzaman "alimuzzaman (241 commits)")[![planv](https://avatars.githubusercontent.com/u/5268508?v=4)](https://github.com/planv "planv (188 commits)")[![balexey88](https://avatars.githubusercontent.com/u/12548662?v=4)](https://github.com/balexey88 "balexey88 (130 commits)")[![ewsopp](https://avatars.githubusercontent.com/u/5578537?v=4)](https://github.com/ewsopp "ewsopp (34 commits)")[![andypotanin](https://avatars.githubusercontent.com/u/1255935?v=4)](https://github.com/andypotanin "andypotanin (29 commits)")[![Mashenka](https://avatars.githubusercontent.com/u/5111163?v=4)](https://github.com/Mashenka "Mashenka (7 commits)")[![fqjony](https://avatars.githubusercontent.com/u/12067297?v=4)](https://github.com/fqjony "fqjony (6 commits)")[![walle89](https://avatars.githubusercontent.com/u/225431?v=4)](https://github.com/walle89 "walle89 (5 commits)")[![felixarntz](https://avatars.githubusercontent.com/u/3531426?v=4)](https://github.com/felixarntz "felixarntz (3 commits)")[![wiiiimm](https://avatars.githubusercontent.com/u/179761?v=4)](https://github.com/wiiiimm "wiiiimm (2 commits)")[![dchenk](https://avatars.githubusercontent.com/u/17372886?v=4)](https://github.com/dchenk "dchenk (2 commits)")[![donbowman](https://avatars.githubusercontent.com/u/5131923?v=4)](https://github.com/donbowman "donbowman (2 commits)")[![kavaribes](https://avatars.githubusercontent.com/u/17166792?v=4)](https://github.com/kavaribes "kavaribes (1 commits)")[![megazalrock](https://avatars.githubusercontent.com/u/819737?v=4)](https://github.com/megazalrock "megazalrock (1 commits)")[![mehulkaklotar](https://avatars.githubusercontent.com/u/4090336?v=4)](https://github.com/mehulkaklotar "mehulkaklotar (1 commits)")[![michaelaguiar](https://avatars.githubusercontent.com/u/138890?v=4)](https://github.com/michaelaguiar "michaelaguiar (1 commits)")[![nitin-pandita](https://avatars.githubusercontent.com/u/91310284?v=4)](https://github.com/nitin-pandita "nitin-pandita (1 commits)")[![Jessedev1](https://avatars.githubusercontent.com/u/60600868?v=4)](https://github.com/Jessedev1 "Jessedev1 (1 commits)")[![reuben-li](https://avatars.githubusercontent.com/u/18251461?v=4)](https://github.com/reuben-li "reuben-li (1 commits)")

### Embed Badge

![Health badge](/badges/wpcloud-wp-stateless/health.svg)

```
[![Health](https://phpackages.com/badges/wpcloud-wp-stateless/health.svg)](https://phpackages.com/packages/wpcloud-wp-stateless)
```

###  Alternatives

[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

728272.9k20](/packages/civicrm-civicrm-core)[firefly-iii/data-importer

Firefly III Data Import Tool.

7545.8k](/packages/firefly-iii-data-importer)[rainlab/blog-plugin

Blog plugin for October CMS

17257.7k](/packages/rainlab-blog-plugin)[civicrm/civicrm-drupal-8

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

18238.1k2](/packages/civicrm-civicrm-drupal-8)[mediawiki/semantic-glossary

A terminology markup extension with a Semantic MediaWiki back-end

1352.4k](/packages/mediawiki-semantic-glossary)[mediawiki/semantic-cite

A Semantic MediaWiki extension to manage citation resources.

2310.2k1](/packages/mediawiki-semantic-cite)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
