Debug Toolbar

smile/module-debug-toolbar

Adds a debug toolbar to Magento 2, displaying request/response data, SQL queries, profiler information, layout details, and cached items. Helps developers debug by providing insights into application execution.

No errors foundPHPStan level 0Build passingSemVer compliant
Supported Magento versions
2.4.9
License
EPL-2.0
Categories
Developer Tools

278,132 installs★ 148 stars5,113 downloads/monthLatest: v7.0.3Released 2026-03-23

composer require smile/module-debug-toolbar

README

Reproduced from the package’s own README, under its own license, as of 2026-10-31. Links and images point back at the source repository.

Smile Debug Toolbar for Magento 2

Description

This module adds a Debug Toolbar in Magento 2. The toolbar displays useful information about the last executions (including ajax requests, rest API and graphql):

  • HTTP Request/response
  • SQL queries (with the PHP trace for each query)
  • Profiler information (with timers)
  • Layout information
  • Cached items
  • Plugins/observers that were triggered

Installation

To install the module:

  1. Execute the following command at the root of the Magento installation:
    composer require --dev smile/module-debug-toolbar
  2. Enable the module:
    bin/magento module:enable Smile_DebugToolbar
    bin/magento setup:upgrade
  3. Enable the toolbar:
    bin/magento config:set smile_debugtoolbar/configuration/enabled 1
    

Configuration

The configuration of the module is available in the section Smile > Smile DebugToolbar of the admin area:

You can:

  • Enable / disable the debug toolbar (default: disabled)
  • Show / hide the debug toolbar in the admin area (default: hidden)
  • Choose the number of last executions to save and display in the toolbar (default: 5)

Uninstallation

Unfortunately, the module cannot be automatically uninstalled, because Magento doesn't support uninstallation of dev packages out of the box.

To uninstall the module, follow these steps:

  1. In app/etc/env.php, remove the key db.connection.default.profiler from the array if it is defined.
  2. Run the following commands:
    bin/magento module:disable Smile_DebugToolbar
    composer remove --dev smile/module-debug-toolbar
    bin/magento setup:upgrade
    
  3. [Optional] Remove the directory "var/smile_toolbar".

Customizing the Toolbar

It is possible to add new zones to the toolbar (e.g. to display project-specific data). This is documented here.

Contributing

You can contribute to this module by submitting issues or pull requests.

For more details, please take a look at the contribution guidelines.

License

This module is licensed under the Eclipse Public License - v 2.0.

Changelog

All notable changes are recorded in this changelog.

Contact

Smile Technical Office dirtech@smile.fr

← All packages from smile