| **[`Permissions`](#permissions)** | Set permissions associated with camera, microphone, location, and notifications.
| **[`PictureInPicture`](#pictureinpicture)** | Enable or disable Picture-in-Picture.
| **[`PopupBlocking`](#popupblocking)** | Configure the default pop-up window policy as well as origins for which pop-up windows are allowed.
-| **[`Preferences`](#preferences)** | Set and lock some preferences.
+| **[`Preferences`](#preferences)** | Set and lock preferences.
+| **[`Preferences (Deprecated)`](#preferences--deprecated)** | Set and lock some preferences.
| **[`PromptForDownloadLocation`](#promptfordownloadlocation)** | Ask where to save each file before downloading.
| **[`Proxy`](#proxy)** | Configure proxy settings.
| **[`RequestedLocales`](#requestedlocales)** | Set the the list of requested locales for the application in order of preference.
}
```
### Preferences
+Set and lock preferences.
+
+Previously you could only set and lock a subset of preferences. Starting with Firefox 81 and Firefox ESR 78.3 you can set many more preferences. You can also set default preferences, user preferences and you can clear preferences.
+
+Preferences that start with the following prefixes are supported:
+```
+accessibility.
+browser.
+datareporting.policy.
+dom.
+extensions.
+geo.
+intl.
+layout.
+media.
+network.
+places.
+print.
+ui.
+widget.
+```
+as well as the following security preferences:
+```
+security.default_personal_cert
+security.insecure_connection_text.enabled
+security.insecure_connection_text.pbmode.enabled
+security.insecure_field_warning.contextual.enabled
+security.mixed_content.block_active_content
+security.osclientcerts.autoload
+security.ssl.errorReporting.enabled
+security.tls.hello_downgrade_check
+security.warn_submit_secure_to_insecure
+```
+Using the preference as the key, set the `Value` to the corresponding preference value.
+
+`Status` can be "default", "locked", "user" or "clear"
+
+If a value is locked, it is also set as the default.
+
+User preferences persist across invocations of Firefox.
+
+See the examples below for more detail.
+
+IMPORTANT: Make sure you're only setting a particular preference using this mechanism and not some other way.
+
+Status
+**Compatibility:** Firefox 81, Firefox ESR 78.3\
+**CCK2 Equivalent:** `preferences`\
+**Preferences Affected:** Many
+
+#### Windows (GPO)
+```
+Software\Policies\Mozilla\Firefox\Preferences (REG_MULTI_SZ) =
+{
+ "accessibility.force_disabled": {
+ "Value": 1,
+ "Status": "default"
+ },
+ "browser.cache.disk.parent_directory": {
+ "Value": "SOME_NATIVE_PATH",
+ "Status": "user"
+ },
+ "browser.tabs.warnOnClose": {
+ "Value": false,
+ "Status": "locked"
+ }
+}
+```
+#### Windows (Intune)
+OMA-URI:
+```
+./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/Preferences
+```
+Value (string):
+```
+<enabled/>
+<data id="Preferences" value='
+{
+ "accessibility.force_disabled": {
+ "Value": 1,
+ "Status": "default"
+ },
+ "browser.cache.disk.parent_directory": {
+ "Value": "SOME_NATIVE_PATH",
+ "Status": "user"
+ },
+ "browser.tabs.warnOnClose": {
+ "Value": false,
+ "Status": "locked"
+ }
+}'/>
+```
+#### macOS
+```
+<dict>
+ <key>Preferences</key>
+ <dict>
+ <key>accessibility.force_disabled</key>
+ <dict>
+ <key>Value</key>
+ <integer>1</integer>
+ <key>Status</key>
+ <string>default</string>
+ </dict>
+ <key>browser.cache.disk.parent_directory</key>
+ <dict>
+ <key>Value</key>
+ <string>SOME_NATIVE_PATH</string>
+ <key>Status</key>
+ <string>user</string>
+ </dict>
+ <key>browser.tabs.warnOnClose</key>
+ <dict>
+ <key>Value</key>
+ <false/>
+ <key>Status</key>
+ <string>locked</string>
+ </dict>
+ </dict>
+</dict>
+```
+#### policies.json
+```
+{
+ "policies": {
+ "Preferences": {
+ "accessibility.force_disabled": {
+ "Value": 1,
+ "Status": "default"
+ },
+ "browser.cache.disk.parent_directory": {
+ "Value": "SOME_NATIVE_PATH",
+ "Status": "user"
+ },
+ "browser.tabs.warnOnClose": {
+ "Value": false,
+ "Status": "locked"
+ }
+ }
+ }
+}
+```
+### Preferences (Deprecated)
Set and lock certain preferences.
**Compatibility:** See below\
</dict>
<key>Preferences</key>
<dict>
- <key>app.update.auto</key>
- <true/>
- <key>security.default_personal_cert</key>
- <string>Ask Every Time</string>
+ <key>accessibility.force_disabled</key>
+ <dict>
+ <key>Value</key>
+ <integer>1</integer>
+ <key>Status</key>
+ <string>default</string>
+ </dict>
+ <key>browser.cache.disk.parent_directory</key>
+ <dict>
+ <key>Value</key>
+ <string>SOME_NATIVE_PATH</string>
+ <key>Status</key>
+ <string>user</string>
+ </dict>
+ <key>browser.tabs.warnOnClose</key>
+ <dict>
+ <key>Value</key>
+ <false/>
+ <key>Status</key>
+ <string>locked</string>
+ </dict>
</dict>
<key>Proxy</key>
<dict>
<string id="Flash_group">Flash</string>
<string id="Homepage_group">Startseite</string>
<string id="Search_group">Suche</string>
- <string id="Preferences_group">Einstellungen</string>
+ <string id="Preferences_group">Einstellungen (Veraltet)</string>
<string id="UserMessaging_group">Benutzer-Benachrichtigungen</string>
<string id="DisabledCiphers_group">Disabled Ciphers</string>
<string id="EncryptedMediaExtensions_group">DRM-Medien Erweiterungen</string>
Für eine Beschreibung der Einstellung, siehe:
https://github.com/mozilla/policy-templates/blob/master/README.md#handlers (Englisch)</string>
+ <string id="Preferences">Einstellungen</string>
+ <string id="Preferences_Explain">If this policy is enabled, you can use JSON to configure preferences.
+
+If this policy is disabled or not configured, preferences are not modified.
+
+For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#preferences.</string>
<string id="Preferences_Boolean_Explain">Wenn diese Richtlinieneinstellung aktiviert ist, ist die Einstellung auf true gesperrt. Wenn diese Richtlinieneinstellung deaktiviert ist, ist die Einstellung auf false gesperrt.
Für eine Beschreibung der Einstellung, siehe:
<presentation id="Autoplay_Default">
<dropdownList refId="Autoplay_Default"/>
</presentation>
+ <presentation id="JSON">
+ <multiTextBox refId="JSON"/>
+ </presentation>
</presentationTable>
</resources>
</policyDefinitionResources>
<string id="Flash_group">Flash</string>
<string id="Homepage_group">Home page</string>
<string id="Search_group">Search</string>
- <string id="Preferences_group">Preferences</string>
+ <string id="Preferences_group">Preferences (Deprecated)</string>
<string id="UserMessaging_group">User Messaging</string>
<string id="DisabledCiphers_group">Disabled Ciphers</string>
<string id="EncryptedMediaExtensions_group">Encrypted Media Extensions</string>
If this policy is disabled or not configured, Firefox defaults are used.
For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#handlers.</string>
+ <string id="Preferences">Preferences</string>
+ <string id="Preferences_Explain">If this policy is enabled, you can use JSON to configure preferences.
+
+If this policy is disabled or not configured, preferences are not modified.
+
+For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#preferences.</string>
<string id="Preferences_Boolean_Explain">If this policy is enabled, the preference is locked to true. If this policy is disabled, the preference is locked to false.
For a description of the preference, see:
<presentation id="Autoplay_Default">
<dropdownList refId="Autoplay_Default"/>
</presentation>
+ <presentation id="JSON">
+ <multiTextBox refId="JSON"/>
+ </presentation>
</presentationTable>
</resources>
</policyDefinitionResources>
<string id="Flash_group">Flash</string>
<string id="Homepage_group">Página de inicio</string>
<string id="Search_group">Búsqueda</string>
- <string id="Preferences_group">Preferencias</string>
+ <string id="Preferences_group">Preferencias (obsoleto)</string>
<string id="UserMessaging_group">Mensajería del usuario</string>
<string id="DisabledCiphers_group">Cifrados deshabilitados</string>
<string id="EncryptedMediaExtensions_group">Extensiones de medios cifrados</string>
If this policy is disabled or not configured, Firefox defaults are used.
For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#handlers.</string>
+ <string id="Preferences">Preferencias</string>
+ <string id="Preferences_Explain">If this policy is enabled, you can use JSON to configure preferences.
+
+If this policy is disabled or not configured, preferences are not modified.
+
+For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#preferences.</string>
<string id="Preferences_Boolean_Explain">Si esta política está habilitada, la preferencia se bloquea en true. Si esta política está deshabilitada, la preferencia está bloqueada en false.
Para una descripción de la preferencia, visita:
<presentation id="Autoplay_Default">
<dropdownList refId="Autoplay_Default"/>
</presentation>
+ <presentation id="JSON">
+ <multiTextBox refId="JSON"/>
+ </presentation>
</presentationTable>
</resources>
</policyDefinitionResources>
<multiText id="Handlers" valueName="Handlers" maxLength="2048"/>
</elements>
</policy>
+ <policy name="Preferences" class="Both" displayName="$(string.Preferences)" key="Software\Policies\Mozilla\Firefox" explainText="$(string.Preferences_Explain)" presentation="$(presentation.JSON)">">
+ <parentCategory ref="firefox"/>
+ <supportedOn ref="SUPPORTED_FF81"/>
+ <elements>
+ <multiText id="JSON" valueName="Preferences" maxLength="2048"/>
+ </elements>
+ </policy>
</policies>
</policyDefinitions>
<string id="Flash_group">Flash</string>\r
<string id="Homepage_group">Page d'accueil</string>\r
<string id="Search_group">Recherche</string>\r
- <string id="Preferences_group">Préférences</string>\r
+ <string id="Preferences_group">Préférences (Deprecated)</string>\r
<string id="UserMessaging_group">User Messaging</string>\r
<string id="DisabledCiphers_group">Disabled Ciphers</string>\r
<string id="EncryptedMediaExtensions_group">Encrypted Media Extensions</string>\r
If this policy is disabled or not configured, Firefox defaults are used.\r
\r
For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#handlers.</string>\r
+ <string id="Preferences">Préférences</string>\r
+ <string id="Preferences_Explain">If this policy is enabled, you can use JSON to configure preferences.\r
+\r
+If this policy is disabled or not configured, preferences are not modified.\r
+\r
+For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#preferences.</string>\r
<string id="Preferences_Boolean_Explain">Si cette stratégie est activée, la préférence est verrouillée sur true. Si cette stratégie est désactivée, la préférence est verrouillée sur false.\r
\r
Pour une description de la préférence, voir:\r
<presentation id="Autoplay_Default">\r
<dropdownList refId="Autoplay_Default"/>\r
</presentation>\r
+ <presentation id="JSON">\r
+ <multiTextBox refId="JSON"/>\r
+ </presentation>\r
</presentationTable>\r
</resources>\r
</policyDefinitionResources>\r
<string id="Flash_group">Flash</string>
<string id="Homepage_group">Pagina iniziale</string>
<string id="Search_group">Ricerca</string>
- <string id="Preferences_group">Preferenze</string>
+ <string id="Preferences_group">Preferenze (deprecata)</string>
<string id="UserMessaging_group">Messaggi utente</string>
<string id="DisabledCiphers_group">Cifrari disabilitati</string>
<string id="EncryptedMediaExtensions_group">Encrypted Media Extensions</string>
Se questo criterio è disabilitato o non configurato, vengono utilizzati i criteri predefiniti di Firefox.
Per informazioni dettagliate sulla creazione del criterio, si veda https://github.com/mozilla/policy-templates/blob/master/README.md#handlers.</string>
+ <string id="Preferences">Preferenze</string>
+ <string id="Preferences_Explain">If this policy is enabled, you can use JSON to configure preferences.
+
+If this policy is disabled or not configured, preferences are not modified.
+
+For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#preferences.</string>
<string id="Preferences_Boolean_Explain">Se questo criterio è abilitato, la preferenza è impostata a Vero e resa non modificabile. Se questo criterio è disabilitato, la preferenza è impostata a Falso e resa non modificabile.
Per una descrizione della preferenza, si veda:
<presentation id="Autoplay_Default">
<dropdownList refId="Autoplay_Default"/>
</presentation>
+ <presentation id="JSON">
+ <multiTextBox refId="JSON"/>
+ </presentation>
</presentationTable>
</resources>
</policyDefinitionResources>
<string id="Flash_group">Flash</string>
<string id="Homepage_group">首頁</string>
<string id="Search_group">搜尋</string>
- <string id="Preferences_group">偏好設定</string>
+ <string id="Preferences_group">偏好設定(已棄用)</string>
<string id="UserMessaging_group">顯示給使用者的訊息</string>
<string id="DisabledCiphers_group">停用加密演算法</string>
<string id="EncryptedMediaExtensions_group">加密媒體擴充功能</string>
若停用或不設定此原則,則使用 Firefox 預設設定。
若需要建立原則的詳細資訊,請參考 https://github.com/mozilla/policy-templates/blob/master/README.md#handlers。</string>
+ <string id="Preferences">偏好設定</string>
+ <string id="Preferences_Explain">If this policy is enabled, you can use JSON to configure preferences.
+
+If this policy is disabled or not configured, preferences are not modified.
+
+For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#preferences.</string>
<string id="Preferences_Boolean_Explain">若啟用此原則,偏好設定將鎖定為 true。若停用此原則,偏好設定則鎖定為 false。
若需要偏好設定的詳細說明,請參考:
<presentation id="Autoplay_Default">
<dropdownList refId="Autoplay_Default"/>
</presentation>
+ <presentation id="JSON">
+ <multiTextBox refId="JSON"/>
+ </presentation>
</presentationTable>
</resources>
</policyDefinitionResources>
\ No newline at end of file