Developer mode (debug mode)

The developer mode, also known as debug mode, unlocks access to advanced tools and settings in Odoo.

Warning

Proceed with caution, as some developer tools and technical settings are considered advanced and may have associated risks. Only use them if you understand the implications and are confident in your actions.

Note

The developer mode is also available with assets, which are used to debug JavaScript code, and with tests assets, which are used to run test tours.

Activation

To activate it, open the Settings app, scroll down to the Developer Tools section, and click Activate the developer mode.

Once activated, the Deactivate the developer mode option becomes available.

screenshot: general-developer-mode-settings
menu
Settings ‣ General Settings ‣ Developer Tools
shows
The Developer Tools section with the links "Activate the developer mode", "Activate the developer mode (with assets)", "Activate the developer mode (with tests assets)".
highlight
"Activate the developer mode".
module
base_setup
notes
English UI, crop to the section.

To activate the developer mode from anywhere in the database, add ?debug=1 at the end of the URL (e.g., https://example.com/odoo?debug=1). To deactivate it, use ?debug=0 instead.

Use ?debug=assets to activate the developer mode with assets and ?debug=tests to activate it with tests assets.

Tip

Open the command palette by pressing Ctrl + K or Cmd ⌘ + K, then type debug to activate the developer mode with assets or deactivate it.

Browser extension

The Odoo Debug browser extension adds an icon to toggle developer mode on or off from the browser’s toolbar. It is available on the Chrome Web Store and Firefox Add-ons.

Developer tools and technical menu

Once the developer mode is activated, the developer tools can be accessed by clicking the (bug) icon. The menu contains tools useful for understanding or editing technical data, such as a view’s field, filters, or actions. The options available depend on where the menu is accessed from.

screenshot: general-developer-mode-bug-menu
menu
Sales ‣ Orders ‣ Quotations (developer mode)
shows
The bug icon in the top menu bar clicked, with the developer tools dropdown open (Edit View, Edit Action, Edit Search, Manage Filters, Technical Translation, View Fields, …).
highlight
The bug icon.
module
web
notes
English UI, developer mode active, crop to the top bar and dropdown.

Database administrators can access the technical menu from the Settings app. It contains advanced database settings, such as ones related to the database structure, security, actions, etc.

screenshot: general-developer-mode-technical-menu
menu
Settings ‣ Technical
shows
The Settings app's Technical menu expanded, listing its sections (Discuss, Email, Activities, Automation, Actions, User Interface, Database Structure, Sequences & Identifiers, Security, …).
highlight
The "Technical" menu.
module
base
notes
English UI, developer mode active, crop to the menu.