index.md

---

title: action.enable()
slug: Mozilla/Add-ons/WebExtensions/API/action/enable
page-type: webextension-api-function
tags:
  - API
  - Add-ons
  - Enable
  - Extensions
  - Method
  - Non-standard
  - Reference
  - WebExtensions
  - action
browser-compat: webextensions.api.action.enable

---

{{AddonSidebar()}}

Enables the browser action for a tab. By default, browser actions are enabled for all tabs.

Note: This API is available in Manifest V3 or higher.

Syntax

browser.action.enable(
  tabId // optional integer
)

Parameters

• tabId {{optional_inline}}

  • : integer. The id of the tab for which you want to enable the browser action.

Examples

Disable the browser action when clicked, and re-enable it every time a new tab is opened:

browser.tabs.onCreated.addListener(() => {
  browser.action.enable();
});

browser.action.onClicked.addListener(() => {
  browser.action.disable();
});

{{WebExtExamples}}

Browser compatibility

{{Compat}}

Note: This API is based on Chromium's chrome.action API. This documentation is derived from browser_action.json in the Chromium code.