How to Enable Profiler for Magento 2 Stores

The Most Popular Extension Builder for Magento 2

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

mageplaza extensions M2

The launch of Magento 2 has brought a lot of benefits to e-commerce stores. Magento 2 offers a lot of powerful functions as well as integrated intelligent extensions. Creating a faster Magento 2 store is an easy job; however, it is difficult to predict how good an add-on will be as well as to know if it is suitable for a Magento store or not. There are now various tools that help you debug and measure which extensions on your store are taking up too much memory and consuming time. One of the most highly recommended internal debuggers that we would like to mention is Profiler.

In this blog post, we will learn How to Enable Profiler for Magento 2 stores.

Without further ado, let’s get started!

Table of Contents

Benefits of Profiler for Magento 2 stores

Profiler is an internal debugging tool that plays an important role in the development of Magento. It is built in Magento, which helps to identify performance issues on your server. In addition, it also allows you to get a Magento partial load time report. Thanks to this, you can check and see which apps consume your memory and slow down the page load on your online store.

Currently, Magento supports 3 profiler formats: HTML, CSV file, and Firebug. All preset formats are used to analyze performance tasks, show dependency graphs on the Magento page, reveal unused dependencies to cut down memory and time. You can totally solve all of the above by enabling Profiler in Magento 2.

Let’s jump right into detail!

How to enable Magento 2 Profiler

With previous versions of Magento 2, there are several ways to enable Profiler for eCommerce stores. With the current version, however, there is only one way to allow it. That is to use the .htaccess file. We will explore step-by-step right now.

Step 1: Add the code in .htaccess file

All you need to do is add the code below in .htaccess file at Magento root directory:


Add the code in .htaccess file
Add the code in .htaccess file

Step 2: Set the value of MAGE_PROFILER

Next, please set the value of MAGE_PROFILER in 3 cases as the following:

  • csv file: You can find the reports in /var/log/profiler.csv
  • html: You can find the results in blocks of HTML code at the end of your store’s homepage
  • firebug: You can find the reports in /var/log/profiler.csv using Firebug output
Set the value of MAGE_PROFILER
Set the value of MAGE_PROFILER

Step 3: Enable Magento 2 Developer mode

To enable Magento 2 Developer Mode, please log in to your SSH, navigate to your store root directory and run the following command:

php bin/magento dev:profiler:enable <type>

Step 4: Refresh the cache

Last but not least, you need to compile as well as refresh the cache to finish.

Check your results

Depending on your configuration, you will see the following output:

  • In HTML Profiler: The Profiler should be placed below the footer of your online storefront. You just need to open the homepage, scroll down and you will see a list of timers_id and execution time of each timer as follows:
  • CSV File: This file is stored in the var/log directory.
  • Dependency graphs: You will see the results of the following page when trying to access your storefront as below:

Common issue after enabling Magento 2 Profiler

A fairly common error is that Magento 2 Profiler is not working.

There will be some cases that HTML Profiler doesn’t work after you have enabled them in Magento. The most likely cause is the HTML code that causes javascript execution error.

Don’t worry since you can completely fix this problem by using other configuration modes like csvfile, etc, or make sure HTML Profiler doesn’t affect anything in the functionality.

Final words

After enabling the Profiler in Magento 2, you can easily detect the applications and software that take up a lot of memory, slow down your website system as well as the hidden reasons behind your poor performance.

We hope this tutorial can help you open up a magical world for your Magento 2 store. As a result, your online store will significantly improve performance and, subsequently increase sales efficiency.

If you find our article missed anything important or need to contribute another documentary, please feel free to leave a comment below.

Thanks a lot for reading!

Increase sales,
not your workload

Simple, powerful tools to grow your business. Easy to use, quick to master and all at an affordable price.

Get Started
avada marketing automation

Explore Our Products:


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