Site Level Maintenance Mode
Liferay DXP 2026.Q2+
This feature is behind a release feature flag (LPD-82969) and must be enabled before use. See Feature Flags for more information.
Site-level Maintenance Mode restricts public access while you perform updates. When enabled, unauthenticated and non-administrative users see a maintenance page instead of site content.
This is a site-specific setting: enabling Maintenance Mode on one site does not affect other sites or the Liferay instance as a whole. A deactivated site is inaccessible to all users by default; Maintenance Mode gives administrators full access while keeping the site offline for everyone else.
Enabling Site Level Maintenance Mode
You must be a Site Administrator to access this setting.
-
Navigate to the desired Site.
-
Open the Site Menu
, expand Configuration, and go to Site Settings → Site Configuration → Details. -
Switch the Active toggle to off. The Maintenance Mode toggle becomes available.
-
Enable the Maintenance Mode toggle.
-
Click Save.
Once saved, Maintenance Mode is enabled. Non-administrator users receive the maintenance page with an HTTP 503 status code.
Disabling Maintenance Mode does not reactivate the site automatically. To reactivate the site, switch the Active toggle to on and click Save.
Behavior Summary
| Site State | Maintenance Mode | Public Access | Admin Access |
|---|---|---|---|
| Active | Off | Normal | Normal |
| Deactivated | Off | Blocked | Configuration pages only |
| Deactivated | On | 503 Maintenance Page | All site pages |
When the site is deactivated and Maintenance Mode is off, administrators can only access configuration pages. When Maintenance Mode is on, users with the Administrator, Site Administrator, or Site Owner role can access all site pages to perform updates and verify site health before reactivating the site.