Maintenance Settings

TABLE OF CONTENTS

Storefronts Maintenance Settings

Navigate: System Settings > Global Settings > Maintainace

A new feature has been introduced that allows admin to manage the Storefronts operational status. With this configuration, admin can easily toggle the Storefront between "Live” and “Under Maintenance” modes whenever needed.


  • Setting the Flag to "Yes" initiates store maintenance for all stores and redirects all Storefront users to the maintenance page.
  • Setting the Flag to "No" keeps all stores live, and Storefront users can proceed with normal operations.


Use Cases

Use Case 1: Enable Maintenance Mode for All Stores (Global Control)

Scenario

An admin needs to temporarily disable all storefronts (for upgrades, deployments, or system maintenance).

Steps

  1. Navigate to System Settings in the Admin Console.
  2. Select Global Settings.
  3. Click on Maintenance.
  4. Locate the setting Enable Maintenance for All Stores.
  5. Set the value to Yes.
  6. Save the configuration.

Expected Outcome

  • All stores are immediately placed under maintenance.
  • All users (guest and registered) are redirected to the maintenance page.
  • Any page accessed by users returns a 503 Service Unavailable response.

Use Case 2: Keep All Stores Live (Disable Global Maintenance)

Scenario

An admin wants to ensure all storefronts remain accessible to customers.

Steps

  1. Navigate to System Settings.
  2. Select Global Settings.
  3. Click on Maintenance.
  4. Locate Enable Maintenance for All Stores.
  5. Set the value to No.
  6. Save the configuration.

Expected Outcome

  • Global maintenance is disabled.
  • The system now relies on store-level settings to determine maintenance status.

Use Case 3: Enable Maintenance Mode for a Specific Store

Scenario

An admin wants to perform maintenance on a single store without affecting others.

Steps

  1. Navigate to Stores in the Admin Console.
  2. Select Stores.
  3. Click on Manage Store for the desired store.
  4. Navigate to Additional Attributes.
  5. Locate the Webstore Under Maintenance setting.
  6. Set the value to Yes.
  7. Save the changes.

Expected Outcome

  • Only the selected store enters maintenance mode.
  • Users accessing this store are redirected to the maintenance page.
  • A 503 Service Unavailable error is triggered for this store.
  • Other stores remain live if their maintenance flag is set to No.

Use Case 4: Keep a Specific Store Live

Scenario

An administrator ensures a store remains accessible while others may be under maintenance.

Steps

  1. Navigate to Stores.
  2. Select Manage Store.
  3. Go to Additional Attributes.
  4. Locate Webstore Under Maintenance.
  5. Set the value to No.
  6. Save the configuration.

Expected Outcome

  • The store remains live and accessible to all users.
  • Customers can browse and perform transactions normally.

Validation Rules and Behavior

  • If Enable Maintenance for All Stores = Yes, all stores go into maintenance mode regardless of store-level settings.
  • If Enable Maintenance for All Stores = No, the system checks each Storefront Under Maintenance value.
  • When maintenance mode is enabled (global or store-level):
    • All users are redirected to the maintenance page.
    • Active sessions are interrupted.
    • A 503 Service Unavailable status is returned.

Important Notes

  • The system prioritizes the global maintenance flag over the store-level setting. If the “Enable Maintenance for All Stores” flag under System Settings > Global Settings > Maintenance is set to "Yes", all stores will enter maintenance mode, regardless of the individual store-level setting “storefront Under Maintenance” found under Stores > Stores > Manage Store > Additional Attributes > Maintenance Mode.
  • If the global “Enable Maintenance for All Stores” flag is set to "No", the system will refer to the store-level “storefront Under Maintenance” setting and apply maintenance mode based on its value. That is, if it is set to “Yes”, that particular store goes under maintenance. And if it is set to “No”, the store will be live and accessible for all the webstore users.
  • As soon as the “storefront Under Maintenance” attribute/flag is set to “Yes”, it results in a 503 Service Unavailable error, and all users (Guest and Registered) will be redirected to the maintenance page, regardless of what page they were on.
  • When a new store is created, the “Store Mode” column remains blank until the store is published.



Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.