Title: Planned Outage for Block Themes Author: Troy Chaplin Published: 29, Xineru de 2026 Last modified: 13, Febreru de 2026 --- Guetar plugins ![](https://ps.w.org/planned-outage/assets/banner-772x250.png?rev=3449795) ![](https://ps.w.org/planned-outage/assets/icon-256x256.png?rev=3449795) # Planned Outage for Block Themes By [Troy Chaplin](https://profiles.wordpress.org/areziaal/) [Download](https://downloads.wordpress.org/plugin/planned-outage.1.2.1.zip) * [Details](https://ast.wordpress.org/plugins/planned-outage/#description) * [Reviews](https://ast.wordpress.org/plugins/planned-outage/#reviews) * [Installation](https://ast.wordpress.org/plugins/planned-outage/#installation) * [Development](https://ast.wordpress.org/plugins/planned-outage/#developers) [Support](https://wordpress.org/support/plugin/planned-outage/) ## Description Planned Outage for Block Themes is a lightweight plugin that enables maintenance mode for WordPress block themes. When enabled, logged-out visitors see your custom maintenance template while logged-in users can browse the site normally. **Features:** * Uses native block theme templates * Create maintenance pages in the Site Editor or as theme files * Logged-in users bypass maintenance mode * Configurable expected duration (Retry-After header) * Pre-launch mode for sites that aren’t live yet * Optional search engine bot access during maintenance * Bypass link to let non-logged-in users preview the site during maintenance * Admin bar indicator when maintenance mode is active * Duration warning after 3 days of maintenance (except in pre-launch mode) * Returns proper 503 status code for SEO * Cache plugin detection with admin warning and automatic cache flushing **Requirements:** * WordPress 6.3 or higher * A block theme (like Twenty Twenty-Five) ## Installation 1. Upload the plugin folder to your /wp-content/plugins/ folder. 2. Go to the **Plugins** page and activate the plugin. 3. Create a maintenance template (see FAQ below). 4. Go to **Settings > Planned Outage** and enable it. ## FAQ ### How do I create a maintenance template? You have two options: 1. **Site Editor:** Go to Appearance > Editor > Templates, create a new template named“ maintenance” 2. **Theme file:** Add a `maintenance.html` file to your theme’s `/templates/` folder ### Who can see the site when maintenance mode is enabled? All logged-in users can browse the site normally. Only logged-out visitors see the maintenance template. You can also enable search engine bots to bypass maintenance mode, or generate a bypass link for non-logged-in users. ### What is the Expected Duration setting? This sets the Retry-After HTTP header, which tells search engines how long to wait before checking your site again. Options range from 30 minutes to 1 day. You can also select “Pre-Launch (indefinite)” for sites that aren’t live yet, which disables duration tracking and admin warnings. ### What is the Bypass Link? When enabled, the plugin generates a secret URL you can share with anyone who needs to view the site during maintenance without logging in. A 12-hour cookie is set on first visit so they can navigate freely. You can regenerate the link at any time to invalidate the previous one. ### Should I enable Search Engine Access? For short maintenance periods (under 2 hours), the default settings are fine. For longer maintenance (over 2 hours), consider enabling search engine access. For maintenance lasting more than a day, always enable it to prevent pages from being removed from search indexes. ### What status code is returned? The plugin returns a 503 (Service Unavailable) status with a Retry-After header, which tells search engines the site is temporarily unavailable. ### Will this work with caching plugins? The plugin detects popular full-page cache plugins (Surge, WP Super Cache, W3 Total Cache, WP Fastest Cache, LiteSpeed Cache, WP Rocket) and displays a warning on the settings page when one is active. Caches are automatically flushed when settings are saved to ensure the maintenance page is served immediately. Server-level caches (Nginx FastCGI cache, Varnish, Cloudflare, etc.) cannot be detected or flushed by the plugin. If maintenance mode is not working and you use server- level caching, flush that cache manually. ### How to uninstall the plugin? Simply deactivate and delete the plugin. The plugin stores options prefixed with` pobt_` which are removed when you deactivate the plugin. ## Reviews ![](https://secure.gravatar.com/avatar/ad31ec5332ae89a7908ac5e4aedeb83a1d6975f9661bdeaada3c42ba86e16933? s=60&d=retro&r=g) ### 󠀁[Great plugin!](https://wordpress.org/support/topic/great-plugin-41278/)󠁿 [wpapm](https://profiles.wordpress.org/wpapm/) 9, Febreru de 2026 1 reply All the described features work for me. A nice, streamlined plugin. Definitely worth checking out! [ Read all 1 review ](https://wordpress.org/support/plugin/planned-outage/reviews/) ## Contributors & Developers “Planned Outage for Block Themes” is open source software. The following people have contributed to this plugin. Contributors * [ Troy Chaplin ](https://profiles.wordpress.org/areziaal/) [Translate “Planned Outage for Block Themes” into your language.](https://translate.wordpress.org/projects/wp-plugins/planned-outage) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/planned-outage/), check out the [SVN repository](https://plugins.svn.wordpress.org/planned-outage/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/planned-outage/) by [RSS](https://plugins.trac.wordpress.org/log/planned-outage/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### Unreleased * Added cache plugin detection with admin warning when maintenance mode is active * Added automatic cache flushing when plugin settings are saved * Added support for detecting Surge, WP Super Cache, W3 Total Cache, WP Fastest Cache, LiteSpeed Cache, and WP Rocket * Added fallback cache detection via advanced-cache.php dropin and wp-content/cache/ directory * Added no-cache headers on all bypass responses to prevent reverse proxy cache poisoning * Fixed bypass link, logged-in user, and bot responses poisoning server-level caches * Fixed maintenance template not rendering when a static front page is set in Settings > Reading #### 1.1.0 * Added bypass link feature for sharing preview access with non-logged-in users * Added pre-launch mode (indefinite duration) that disables time tracking and admin warnings * Bypass link sets a 12-hour cookie for seamless navigation * Regenerate bypass link to invalidate previous links #### 1.0.0 * Initial release ## Meta * Version **1.2.1** * Last updated **2 meses ago** * Active installations **Fewer than 10** * WordPress version ** 6.3 or higher ** * Tested up to **6.9.4** * PHP version ** 7.0 or higher ** * Language * [English (US)](https://wordpress.org/plugins/planned-outage/) * Tags * [block-theme](https://ast.wordpress.org/plugins/tags/block-theme/)[coming soon](https://ast.wordpress.org/plugins/tags/coming-soon/) [maintenance](https://ast.wordpress.org/plugins/tags/maintenance/)[maintenance mode](https://ast.wordpress.org/plugins/tags/maintenance-mode/) * [Advanced View](https://ast.wordpress.org/plugins/planned-outage/advanced/) ## Ratings 5 out of 5 stars. * [ 1 5-star review ](https://wordpress.org/support/plugin/planned-outage/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/planned-outage/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/planned-outage/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/planned-outage/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/planned-outage/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/planned-outage/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/planned-outage/reviews/) ## Contributors * [ Troy Chaplin ](https://profiles.wordpress.org/areziaal/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/planned-outage/)