diff --git a/files/en-us/mozilla/add-ons/webextensions/manifest.json/browser_specific_settings/index.md b/files/en-us/mozilla/add-ons/webextensions/manifest.json/browser_specific_settings/index.md
index d04c92f47a3084b..aeaedd7f3285b6e 100644
--- a/files/en-us/mozilla/add-ons/webextensions/manifest.json/browser_specific_settings/index.md
+++ b/files/en-us/mozilla/add-ons/webextensions/manifest.json/browser_specific_settings/index.md
@@ -15,12 +15,14 @@ sidebar: addonsidebar
| Mandatory |
- Usually, no (but see also
+ Must be provided with details specified for browser_specific_settings.gecko.data_collection_permissions for new extension submitted to addons.mozilla.org from November 3, 2025.
+
+ Otherwise, usually not required (but see also
When do you need an Add-on ID?). Mandatory if the extension ID cannot be determined, see
- browser_specific_settings.gecko.id.
|
@@ -55,6 +57,15 @@ Firefox stores browser-specific settings in these sub-keys:
The `gecko` sub-key supports these properties:
+- `data_collection_permissions`
+ - : The optional and required data types that the extension collects and transmits for storage and processing outside the extension. These are represented by the properties:
+ - `required`
+ - : The data that the extension requires to be collected and transmitted for its operation. Must contain the value `none`, or one or more of `authenticationInfo`, `bookmarksInfo`, `browsingActivity`, `financialAndPaymentInfo`, `healthInfo`, `locationInfo`, `personalCommunications`, `personallyIdentifyingInfo`, `searchTerms`, `websiteActivity`, or `websiteContent`.
+ - `optional` {{optional_inline}}
+ - : The data that the user can opt to provide. Can contain one or more of `authenticationInfo`, `bookmarksInfo`, `browsingActivity`, `financialAndPaymentInfo`, `healthInfo`, `locationInfo`, `personalCommunications`, `personallyIdentifyingInfo`, `searchTerms`, `technicalAndInteraction`, `websiteActivity`, or `websiteContent`.
+
+ - : For more information, see the Extension Workshop article [Firefox built-in consent for data collection and transmission](https://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/).
+
- `id`
- : The extension ID. When provided, this property must contain 80 characters or less. See [Extensions and the Add-on ID](https://extensionworkshop.com/documentation/develop/extensions-and-the-add-on-id/) to determine when to specify the ID.
- `strict_min_version`
diff --git a/files/en-us/mozilla/firefox/releases/140/index.md b/files/en-us/mozilla/firefox/releases/140/index.md
index 028deda30a3e830..cc3654350cd6342 100644
--- a/files/en-us/mozilla/firefox/releases/140/index.md
+++ b/files/en-us/mozilla/firefox/releases/140/index.md
@@ -74,6 +74,7 @@ No notable changes.
## Changes for add-on developers
- Support added for `unspecified` in {{WebExtAPIRef("cookies.SameSiteStatus")}}. In addition, `unspecified` is now the default value for `sameSite` in {{WebExtAPIRef("cookies.set()")}}. ([Firefox bug 1550032](https://bugzil.la/1550032))
+- Added the `data_collection_permissions` property to the `gecko` sub-key of the manifest key [`browser_specific_settings`](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_settings) for Firefox for desktop. This property enables the Firefox built-in data collection consent feature. See the Extension Workshop article [Firefox built-in consent for data collection and transmission](http://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/). ([Firefox bug 1954524](https://bugzil.la/1954524))
## Experimental web features
diff --git a/files/en-us/mozilla/firefox/releases/142/index.md b/files/en-us/mozilla/firefox/releases/142/index.md
index 0b501978adf057c..82f814f97b42604 100644
--- a/files/en-us/mozilla/firefox/releases/142/index.md
+++ b/files/en-us/mozilla/firefox/releases/142/index.md
@@ -77,6 +77,7 @@ No notable changes.
- The {{WebExtAPIRef("cookies")}} methods now accept and return milliseconds in the fractional part of `expirationDate`. ([Firefox bug 1972757](https://bugzil.la/1972757))
- Adds the {{WebExtAPIRef("browserAction.onUserSettingsChanged")}} and {{WebExtAPIRef("action.onUserSettingsChanged")}} events that listen for changes in the user-specified settings that affect an extension's action. ([Firefox bug 1828220](https://bugzil.la/1828220))
- Adds {{WebExtAPIRef("browserSettings.verticalTabs")}}, which enables extensions to control whether the browser displays the tab bar horizontally or vertically. ([Firefox bug 1946600](https://bugzil.la/1946600))
+- Enabled the Firefox built-in data collection consent feature for Firefox for Android. See the Extension Workshop article [Firefox built-in consent for data collection and transmission](http://extensionworkshop.com/documentation/develop/firefox-builtin-data-consent/). ([Firefox bug 1954524](https://bugzil.la/1954524))
## Experimental web features