The Most Popular Extension Builder for Magento 2

With a big catalog of 224+ extensions for your online store

How to Enable or Disable Maintenance Mode in Magento 2

Maintenance Mode is a useful and important mode in Magento. If you want to temporarily disable your website to test your site before it goes live, or do maintenance tasks such as updating, fixing the bug, etc., you can enable the maintenance mode.

When your website is in maintenance mode, store visitors will receive a Service Temporarily Unavailable message in their web browser instead of the frontend store. However, it is able for authorized IP addresses to access and view the store normally. We also have a post on how to enable or disable the maintenance mode in Magento 2 (Adobe Commerce) via command line that you can take a look at.

So, in this article, I will give you the detailed instructions to enable/ disable maintenance in both Magento 1 and Magento 2.

Website Support
& Maintenance Services

Make sure your store is not only in good shape but also thriving with a professional team yet at an affordable price.

Get Started
mageplaza services

Enable/ disable maintenance mode in Magento:

1. What is Magento 2 maintenance mode?

Magento 2 maintenance mode is a feature that allows you to temporarily disable access to your online store’s frontend while you perform updates, upgrades, or other maintenance tasks. When maintenance mode is enabled, visitors to your website will see a designated maintenance page instead of the regular store pages. This maintenance page typically includes a message informing users that the website is undergoing maintenance, along with any relevant information about the downtime.

You can check if the maintenance mode is enable or not by this follow way:

  • Maintenance mode will turn off, and Magento will work normally when ‘var / .maintenance.flag’ doesn’t exist
  • When ‘var / .maintenance.flag’ exists: Maintenance mode is on, except where ‘var / .maintenance.ip’ is present.

2. Installing maintenance mode preparation checklists

Before configuring Magento 2 maintenance mode, makr sure that you have prepared the followings:

  • Access to Admin Panel: Make sure you have access to the Magento 2 admin panel with administrator privileges.

  • Backup: Perform a full backup of your Magento 2 store, including files and the database. This ensures that you have a safe copy in case anything goes wrong during maintenance mode setup.

  • Maintenance Page Design: Prepare or choose a maintenance page design that displays relevant information to your customers, such as the reason for maintenance, expected downtime, and any alternative contact information.

  • FTP/SSH Access: Maintain access to your store’s files via FTP or SSH. This may be needed to upload the maintenance page, modify files, or revert changes.

  • Developer Mode: Put your store in developer mode to prevent cached content from affecting the display of the maintenance page.

  • Readiness for Downtime: Be ready for your store to be temporarily offline during maintenance. Plan this during low traffic periods to minimize the impact on customers.

  • Notification Strategy: Determine how you will inform your customers about the upcoming maintenance. This could involve sending emails, posting on social media, or displaying a notice on your website before maintenance begins.

  • Scheduled Time: Set a specific start and end time for the maintenance. Clearly communicate this schedule to your team and customers.

By having these elements in place, you’ll be better prepared to smoothly configure Magento 2 maintenance mode without causing inconvenience to your customers and ensuring a seamless user experience during the maintenance period.

3. Enable/ disable maintenance mode in Magento

Enable or Disable Maintenance Mode in Magento 1

To enable/ disable maintenance mode, following the below steps:

  1. Log in to your Magento administrator account via SSH
  2. Change to the directory where Magento is installed. For example, if you install Magento in the document root directory, type cd ~/public_html
  3. Open the index.php file by using your preferred text editor.
  4. Place the following line in the index.php file:

$maintenanceFile = 'maintenance.flag';

Add the following two lines after this line. where is the IP address for which you want to allow access to the front-end store while Magento is in maintenance mode

$ip = $_SERVER['REMOTE_ADDR'];$allowed = array('');


To exempt multiple IP addresses from the maintenance model, separate them with a comma.

For example

$allowed = array('','');

In case you do not know your own IP address, you can access to

  1. Place the following line in the index.php file:

if (file_exists($maintenanceFile)) {

Change the line to look like the following:

if (file_exists($maintenanceFile) && !in_array($ip, $allowed)) {

  1. Exit the editor after saving your changes to the index.php file.

  2. Type the following command on the command prompt:

touch maintenance.flag

After going through these above steps, you set the able status for maintenance mode. Now once you access to Magento website from an authorized IP address, the store displays normally. However, a Service Temporarily Unavailable message will be shown in the web browsers of all other visitors.

  1. To disable maintenance mode and permit all visitors to access the frontend store, type the following command:

rm maintenance.flag

Enable or Disable Maintenance Mode in Magento 2

enable or disable maintenance mode in magento 2

Firstly, let me show you how to enable/ disable the maintenance mode in Magento 2 (Adobe Commerce), following the below process.


Magento detects the maintenance mode as follows:

If var/.maintenance.flag does not exist, the maintenance mode is off and Magento website runs normally.

If var/.maintenance.flag exists, the maintenance mode is on.

However, the maintenance status also depends on the file var/.maintenance.ip. This file will make some exceptions so the Magento 2 maintenance mode can be off even if the var/.maintenance.flag exists.

Now, you will be instructed to enable or disable the maintenance mode by using the following commands.

Enable The Maintenance Mode in Magento 2

Command usage

php bin/magento maintenance:enable [--ip=<ip address>]

For example

php bin/magento maintenance:enable --ip= --ip=

By using the above command, you will disable the maintenance mode for two IP addresses and The IP address of the developer who wants to debug your website is probably usually included in the above command.

Disable The Maintenance Mode in Magento 2

Command usage

php bin/magento maintenance:disable [--ip=<ip address>]

Show Maintenance Status

To know the current status of the maintenance mode, use the below command:

Command usage

php bin/magento maintenance:status

Exempt IP Addresses From Maintenance Mode

To allow access to the frontend store from a specific IP address while Magento website is in maintenance mode, type the following command:

Command usage

php bin/magento maintenance:allow-ips <ip address> .. <ip address> [--none]

For example

php bin/magento maintenance:allow-ips

Learn more: Enable or Disable maintenance mode via Command Line in Magento 2

Mageplaza Magento Support & Maintenance Services

Mageplaza understands the vital role that your Magento store plays in your business success, so we offer the Magento Support and Maintenance Services to help business owner store solve problems in using, operating, maintaining, and maintaining online stores on Magento platform. Our dedicated Support & Maintenance Services are tailored to ensure your store’s continuous optimal performance, security, and growth.

The expert team of Magento professionals is here to provide timely assistance, resolve issues, and keep your store up-to-date with the latest advancements. From regular updates and security patches to troubleshooting and performance optimization, we’ve got you covered.

With Mageplaza’s Support & Maintenance Services, you can focus on your core business while we take care of your Magento store’s well-being. Experience seamless operations, enhanced security, and unmatched reliability – all backed by Mageplaza’s commitment to excellence.

Elevate your Magento store’s performance and secure its future with Mageplaza Support & Maintenance Services. Your success is our priority.

Website Support
& Maintenance Services

Make sure your store is not only in good shape but also thriving with a professional team yet at an affordable price.

Get Started
mageplaza services


The Maintenance Mode allows online stores to conduct tests and make essential adjustments by showing customers the unavailable notice instead of the usual front pages. We have shown you the shortest process to enable/ disable maintenance mode in Magento 2, and now it is your turn to do it. If you have any questions, feel free to ask us!

Our support team is enthusiastic about providing excellent Magento extensions for you with FREE Lifetime update, FREE 1-year support, risk-free 60-day money back. Let us help you quickly grow your online business!

Custom Maintenance Page with FREE extension

Image Description
With over a decade of experience crafting innovative tech solutions for ecommerce businesses built on Magento, Jacker is the mastermind behind our secure and well-functioned extensions. With his expertise in building user-friendly interfaces and robust back-end systems, Mageplaza was able to deliver exceptional Magento solutions and services for over 122K+ customers around the world.

Looking for
Customization & Development Services?

8+ years of experiences in e-commerce & Magento has prepared us for any challenges, so that we can lead you to your success.

Get free consultant
development service

    Explore Our Products:

    People also searched for


    Stay in the know

    Get special offers on the latest news from Mageplaza.

    Earn $10 in reward now!

    Earn $10 in reward now!

    go up