docs/index.md

   1 Firefox policies can be specified using the [Group Policy templates on Windows](https://github.com/mozilla/policy-templates/tree/master/windows), [Intune on Windows](https://support.mozilla.org/kb/managing-firefox-intune), [configuration profiles on macOS](https://github.com/mozilla/policy-templates/tree/master/mac), or by creating a file called `policies.json`. On Windows, create a directory called `distribution` where the EXE is located and place the file there. On Mac, the file goes into `Firefox.app/Contents/Resources/distribution`.  On Linux, the file goes into `firefox/distribution`, where `firefox` is the installation directory for firefox, which varies by distribution or you can specify system-wide policy by placing the file in `/etc/firefox/policies`.
   2
   3 Unfortunately, JSON files do not support comments, but you can add extra entries to the JSON to use as comments. You will see an error in about:policies, but the policies will still work properly. For example:
   4
   5 ```
   6 {
   7   "policies": {
   8     "Authentication": {
   9       "SPNEGO": ["mydomain.com", "https://myotherdomain.com"]
  10     }
  11     "Authentication_Comment": "These domains are required for us"
  12   }
  13 }
  14 ```
  15
  16 | Policy Name | Description
  17 | --- | --- |
  18 | **[`3rdparty`](#3rdparty)** | Set policies that WebExtensions can access via chrome.storage.managed.
  19 | **[`AllowedDomainsForApps`](#alloweddomainsforapps)** | Define domains allowed to access Google Workspace.
  20 | **[`AppAutoUpdate`](#appautoupdate)** | Enable or disable automatic application update.
  21 | **[`AppUpdatePin`](#appupdatepin)** | Prevent Firefox from being updated beyond the specified version.
  22 | **[`AppUpdateURL`](#appupdateurl)** | Change the URL for application update.
  23 | **[`Authentication`](#authentication)** | Configure sites that support integrated authentication.
  24 | **[`AutoLaunchProtocolsFromOrigins`](#autolaunchprotocolsfromorigins)** | Define a list of external protocols that can be used from listed origins without prompting the user.
  25 | **[`BackgroundAppUpdate`](#backgroundappupdate)** | Enable or disable the background updater (Windows only).
  26 | **[`BlockAboutAddons`](#blockaboutaddons)** | Block access to the Add-ons Manager (about:addons).
  27 | **[`BlockAboutConfig`](#blockaboutconfig)** | Block access to about:config.
  28 | **[`BlockAboutProfiles`](#blockaboutprofiles)** | Block access to About Profiles (about:profiles).
  29 | **[`BlockAboutSupport`](#blockaboutsupport)** | Block access to Troubleshooting Information (about:support).
  30 | **[`Bookmarks`](#bookmarks)** | Add bookmarks in either the bookmarks toolbar or menu.
  31 | **[`CaptivePortal`](#captiveportal)** | Enable or disable the detection of captive portals.
  32 | **[`Certificates`](#certificates)** |
  33 | **[`Certificates -> ImportEnterpriseRoots`](#certificates--importenterpriseroots)** | Trust certificates that have been added to the operating system certificate store by a user or administrator.
  34 | **[`Certificates -> Install`](#certificates--install)** | Install certificates into the Firefox certificate store.
  35 | **[`Containers`](#containers)** | Set policies related to [containers](https://addons.mozilla.org/firefox/addon/multi-account-containers/).
  36 | **[`Cookies`](#cookies)** | Configure cookie preferences.
  37 | **[`DefaultDownloadDirectory`](#defaultdownloaddirectory)** | Set the default download directory.
  38 | **[`DisableAppUpdate`](#disableappupdate)** | Turn off application updates.
  39 | **[`DisableBuiltinPDFViewer`](#disablebuiltinpdfviewer)** | Disable the built in PDF viewer.
  40 | **[`DisabledCiphers`](#disabledciphers)** | Disable ciphers.
  41 | **[`DisableDefaultBrowserAgent`](#disabledefaultbrowseragent)** | Prevent the default browser agent from taking any actions (Windows only).
  42 | **[`DisableDeveloperTools`](#disabledevelopertools)** | Remove access to all developer tools.
  43 | **[`DisableFeedbackCommands`](#disablefeedbackcommands)** | Disable the menus for reporting sites.
  44 | **[`DisableFirefoxAccounts`](#disablefirefoxaccounts)** | Disable Firefox Accounts integration (Sync).
  45 | **[`DisableFirefoxScreenshots`](#disablefirefoxscreenshots)** | Remove access to Firefox Screenshots.
  46 | **[`DisableFirefoxStudies`](#disablefirefoxstudies)** | Disable Firefox studies (Shield).
  47 | **[`DisableForgetButton`](#disableforgetbutton)** | Disable the "Forget" button.
  48 | **[`DisableFormHistory`](#disableformhistory)** | Turn off saving information on web forms and the search bar.
  49 | **[`DisableMasterPasswordCreation`](#disablemasterpasswordcreation)** | Remove the master password functionality.
  50 | **[`DisablePasswordReveal`](#disablepasswordreveal)** | Do not allow passwords to be revealed in saved logins.
  51 | **[`DisablePocket`](#disablepocket)** | Remove Pocket in the Firefox UI.
  52 | **[`DisablePrivateBrowsing`](#disableprivatebrowsing)** | Remove access to private browsing.
  53 | **[`DisableProfileImport`](#disableprofileimport)** | Disables the "Import data from another browser" option in the bookmarks window.
  54 | **[`DisableProfileRefresh`](#disableprofilerefresh)** | Disable the Refresh Firefox button on about:support and support.mozilla.org
  55 | **[`DisableSafeMode`](#disablesafemode)** | Disable safe mode within the browser.
  56 | **[`DisableSecurityBypass`](#disablesecuritybypass)** | Prevent the user from bypassing security in certain cases.
  57 | **[`DisableSetDesktopBackground`](#disablesetdesktopbackground)** | Remove the "Set As Desktop Background..." menuitem when right clicking on an image.
  58 | **[`DisableSystemAddonUpdate`](#disablesystemaddonupdate)** | Prevent system add-ons from being installed or updated.
  59 | **[`DisableTelemetry`](#disabletelemetry)** | DisableTelemetry
  60 | **[`DisableThirdPartyModuleBlocking`](#disablethirdpartymoduleblocking)** | Do not allow blocking third-party modules.
  61 | **[`DisplayBookmarksToolbar`](#displaybookmarkstoolbar)** | Set the initial state of the bookmarks toolbar.
  62 | **[`DisplayBookmarksToolbar (Deprecated)`](#displaybookmarkstoolbar-deprecated)** | Set the initial state of the bookmarks toolbar.
  63 | **[`DisplayMenuBar`](#displaymenubar)** | Set the state of the menubar.
  64 | **[`DisplayMenuBar (Deprecated)`](#displaymenubar-deprecated)** | Set the initial state of the menubar.
  65 | **[`DNSOverHTTPS`](#dnsoverhttps)** | Configure DNS over HTTPS.
  66 | **[`DontCheckDefaultBrowser`](#dontcheckdefaultbrowser)** | Don't check if Firefox is the default browser at startup.
  67 | **[`DownloadDirectory`](#downloaddirectory)** | Set and lock the download directory.
  68 | **[`EnableTrackingProtection`](#enabletrackingprotection)** | Configure tracking protection.
  69 | **[`EncryptedMediaExtensions`](#encryptedmediaextensions)** | Enable or disable Encrypted Media Extensions and optionally lock it.
  70 | **[`EnterprisePoliciesEnabled`](#enterprisepoliciesenabled)** | Enable policy support on macOS.
  71 | **[`ExemptDomainFileTypePairsFromFileTypeDownloadWarnings`](#exemptdomainfiletypepairsfromfiletypedownloadwarnings)** | Disable warnings based on file extension for specific file types on domains.
  72 | **[`Extensions`](#extensions)** | Control the installation, uninstallation and locking of extensions.
  73 | **[`ExtensionSettings`](#extensionsettings)** | Manage all aspects of extensions.
  74 | **[`ExtensionUpdate`](#extensionupdate)** | Control extension updates.
  75 | **[`FirefoxHome`](#firefoxhome)** | Customize the Firefox Home page.
  76 | **[`FlashPlugin (Deprecated)`](#flashplugin-deprecated)** | Configure the default Flash plugin policy as well as origins for which Flash is allowed.
  77 | **[`GoToIntranetSiteForSingleWordEntryInAddressBar`](#gotointranetsiteforsinglewordentryinaddressbar)** | Force direct intranet site navigation instead of searching when typing single word entries in the address bar.
  78 | **[`Handlers`](#handlers)** | Configure default application handlers.
  79 | **[`HardwareAcceleration`](#hardwareacceleration)** | Control hardware acceleration.
  80 | **[`Homepage`](#homepage)** | Configure the default homepage and how Firefox starts.
  81 | **[`InstallAddonsPermission`](#installaddonspermission)** | Configure the default extension install policy as well as origins for extension installs are allowed.
  82 | **[`LegacyProfiles`](#legacyprofiles)** | Disable the feature enforcing a separate profile for each installation.
  83 | **[`LegacySameSiteCookieBehaviorEnabled`](#legacysamesitecookiebehaviorenabled)** | Enable default legacy SameSite cookie behavior setting.
  84 | **[`LegacySameSiteCookieBehaviorEnabledForDomainList`](#legacysamesitecookiebehaviorenabledfordomainlist)** | Revert to legacy SameSite behavior for cookies on specified sites.
  85 | **[`LocalFileLinks`](#localfilelinks)** | Enable linking to local files by origin.
  86 | **[`ManagedBookmarks`](#managedbookmarks)** | Configures a list of bookmarks managed by an administrator that cannot be changed by the user.
  87 | **[`ManualAppUpdateOnly`](#manualappupdateonly)** | Allow manual updates only and do not notify the user about updates.
  88 | **[`NetworkPrediction`](#networkprediction)** | Enable or disable network prediction (DNS prefetching).
  89 | **[`NewTabPage`](#newtabpage)** | Enable or disable the New Tab page.
  90 | **[`NoDefaultBookmarks`](#nodefaultbookmarks)** | Disable the creation of default bookmarks.
  91 | **[`OfferToSaveLogins`](#offertosavelogins)** | Control whether or not Firefox offers to save passwords.
  92 | **[`OfferToSaveLoginsDefault`](#offertosaveloginsdefault)** | Set the default value for whether or not Firefox offers to save passwords.
  93 | **[`OverrideFirstRunPage`](#overridefirstrunpage)** | Override the first run page.
  94 | **[`OverridePostUpdatePage`](#overridepostupdatepage)** | Override the upgrade page.
  95 | **[`PasswordManagerEnabled`](#passwordmanagerenabled)** | Remove (some) access to the password manager.
  96 | **[`PasswordManagerExceptions`](#passwordmanagerexceptions)** | Prevent Firefox from saving passwords for specific sites.
  97 | **[`PDFjs`](#pdfjs)** | Disable or configure PDF.js, the built-in PDF viewer.
  98 | **[`Permissions`](#permissions)** | Set permissions associated with camera, microphone, location, and notifications.
  99 | **[`PictureInPicture`](#pictureinpicture)** | Enable or disable Picture-in-Picture.
 100 | **[`PopupBlocking`](#popupblocking)** | Configure the default pop-up window policy as well as origins for which pop-up windows are allowed.
 101 | **[`Preferences`](#preferences)** | Set and lock preferences.
 102 | **[`Preferences (Deprecated)`](#preferences-deprecated)** | Set and lock some preferences.
 103 | **[`PrimaryPassword`](#primarypassword)** | Require or prevent using a primary (formerly master) password.
 104 | **[`PromptForDownloadLocation`](#promptfordownloadlocation)** | Ask where to save each file before downloading.
 105 | **[`Proxy`](#proxy)** | Configure proxy settings.
 106 | **[`RequestedLocales`](#requestedlocales)** | Set the the list of requested locales for the application in order of preference.
 107 | **[`SanitizeOnShutdown` (All)](#sanitizeonshutdown-all)** | Clear all data on shutdown.
 108 | **[`SanitizeOnShutdown` (Selective)](#sanitizeonshutdown-selective)** | Clear data on shutdown.
 109 | **[`SearchBar`](#searchbar)** | Set whether or not search bar is displayed.
 110 | **[`SearchEngines`](#searchengines-this-policy-is-only-available-on-the-esr)** |
 111 | **[`SearchEngines -> Add`](#searchengines--add)** | Add new search engines.
 112 | **[`SearchEngines -> Default`](#searchengines--default)** | Set the default search engine.
 113 | **[`SearchEngines -> PreventInstalls`](#searchengines--preventinstalls)** | Prevent installing search engines from webpages.
 114 | **[`SearchEngines -> Remove`](#searchengines--remove)** | Hide built-in search engines.
 115 | **[`SearchSuggestEnabled`](#searchsuggestenabled)** | Enable search suggestions.
 116 | **[`SecurityDevices`](#securitydevices)** | Install PKCS #11 modules.
 117 | **[`ShowHomeButton`](#showhomebutton)** | Show the home button on the toolbar.
 118 | **[`SSLVersionMax`](#sslversionmax)** | Set and lock the maximum version of TLS.
 119 | **[`SSLVersionMin`](#sslversionmin)** | Set and lock the minimum version of TLS.
 120 | **[`StartDownloadsInTempDirectory`](#startdownloadsintempdirectory)** | Force downloads to start off in a local, temporary location rather than the default download directory.
 121 | **[`SupportMenu`](#supportmenu)** | Add a menuitem to the help menu for specifying support information.
 122 | **[`UserMessaging`](#usermessaging)** | Don't show certain messages to the user.
 123 | **[`UseSystemPrintDialog`](#usesystemprintdialog)** | Print using the system print dialog instead of print preview.
 124 | **[`WebsiteFilter`](#websitefilter)** | Block websites from being visited.
 125 | **[`WindowsSSO`](#windowssso)** | Allow Windows single sign-on for Microsoft, work, and school accounts.
 126
 127 ### 3rdparty
 128
 129 Allow WebExtensions to configure policy. For more information, see [Adding policy support to your extension](https://extensionworkshop.com/documentation/enterprise/adding-policy-support-to-your-extension/).
 130
 131 For GPO and Intune, the extension developer should provide an ADMX file.
 132
 133 **Compatibility:** Firefox 68\
 134 **CCK2 Equivalent:** N/A\
 135 **Preferences Affected:** N/A
 136
 137 #### macOS
 138 ```
 139 <dict>
 140   <key>3rdparty</key>
 141   <dict>
 142     <key>Extensions</key>
 143     <dict>
 144       <key>uBlock0@raymondhill.net</key>
 145       <dict>
 146         <key>adminSettings</key>
 147         <dict>
 148           <key>selectedFilterLists</key>
 149           <array>
 150             <string>ublock-privacy</string>
 151             <string>ublock-badware</string>
 152             <string>ublock-filters</string>
 153             <string>user-filters</string>
 154           </array>
 155         </dict>
 156       </dict>
 157     </dict>
 158   </dict>
 159 </dict>
 160 ```
 161 #### policies.json
 162 ```
 163 {
 164   "policies": {
 165     "3rdparty": {
 166       "Extensions": {
 167         "uBlock0@raymondhill.net": {
 168           "adminSettings": {
 169             "selectedFilterLists": [
 170               "ublock-privacy",
 171               "ublock-badware",
 172               "ublock-filters",
 173               "user-filters"
 174             ]
 175           }
 176         }
 177       }
 178     }
 179   }
 180 }
 181 ```
 182
 183 ### AllowedDomainsForApps
 184
 185 Define domains allowed to access Google Workspace.
 186
 187 This policy is based on the [Chrome policy](https://chromeenterprise.google/policies/#AllowedDomainsForApps) of the same name.
 188
 189 If this policy is enabled, users can only access Google Workspace using accounts from the specified domains. If you want to allow Gmail, you can add ```consumer_accounts``` to the list.
 190
 191 **Compatibility:** Firefox 89, Firefox ESR 78.11\
 192 **CCK2 Equivalent:** N/A\
 193 **Preferences Affected:** N/A
 194
 195 #### Windows (GPO)
 196 ```
 197 Software\Policies\Mozilla\Firefox\AllowedDomainsForApps = "managedfirefox.com,example.com"
 198 ```
 199 #### Windows (Intune)
 200 OMA-URI:
 201 ```
 202 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/AllowedDomainsForApps
 203 ```
 204 Value (string):
 205 ```
 206 <enabled/>
 207 <data id="AllowedDomainsForApps" value="managedfirefox.com,example.com"/>
 208 ```
 209 #### macOS
 210 ```
 211 <dict>
 212   <key>AllowedDomainsForApps</key>
 213   <string>managedfirefox.com,example.com</string>
 214 </dict>
 215 ```
 216 #### policies.json
 217 ```
 218 {
 219   "policies": {
 220     "AllowedDomainsForApps": "managedfirefox.com,example.com"
 221   }
 222 }
 223 ```
 224 ### AppAutoUpdate
 225
 226 Enable or disable **automatic** application update.
 227
 228 If set to true, application updates are installed without user approval within Firefox. The operating system might still require approval.
 229
 230 If set to false, application updates are downloaded but the user can choose when to install the update.
 231
 232 If you have disabled updates via `DisableAppUpdate`, this policy has no effect.
 233
 234 **Compatibility:** Firefox 75, Firefox ESR 68.7\
 235 **CCK2 Equivalent:** N/A\
 236 **Preferences Affected:** `app.update.auto`
 237
 238 #### Windows (GPO)
 239 ```
 240 Software\Policies\Mozilla\Firefox\AppAutoUpdate = 0x1 | 0x0
 241 ```
 242 #### Windows (Intune)
 243 OMA-URI:
 244 ```
 245 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/AppAutoUpdate
 246 ```
 247 Value (string):
 248 ```
 249 <enabled/> or <disabled/>
 250 ```
 251 #### macOS
 252 ```
 253 <dict>
 254   <key>AppAutoUpdate</key>
 255   <true/> | <false/>
 256 </dict>
 257 ```
 258 #### policies.json
 259 ```
 260 {
 261   "policies": {
 262     "AppAutoUpdate": true | false
 263   }
 264 }
 265 ```
 266 ### AppUpdatePin
 267
 268 Prevent Firefox from being updated beyond the specified version.
 269
 270 You can specify the any version as ```xx.``` and Firefox will be updated with all minor versions, but will not be updated beyond the major version.
 271
 272 You can also specify the version as ```xx.xx``` and Firefox will be updated with all patch versions, but will not be updated beyond the minor version.
 273
 274 You should specify a version that exists or is guaranteed to exist. If you specify a version that doesn't end up existing, Firefox will update beyond that version.
 275
 276 **Compatibility:** Firefox 102,\
 277 **CCK2 Equivalent:** N/A\
 278 **Preferences Affected:** N/A
 279
 280 #### Windows (GPO)
 281 ```
 282 Software\Policies\Mozilla\Firefox\AppUpdatePin = "106."
 283 ```
 284 #### Windows (Intune)
 285 OMA-URI:
 286 ```
 287 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/AppUpdatePin
 288 ```
 289 Value (string):
 290 ```
 291 <enabled/>
 292 <data id="AppUpdatePin" value="106."/>
 293 ```
 294 #### macOS
 295 ```
 296 <dict>
 297   <key>AppUpdatePin</key>
 298   <string>106.</string>
 299 </dict>
 300 ```
 301 #### policies.json
 302 ```
 303 {
 304   "policies": {
 305     "AppUpdatePin": "106."
 306   }
 307 }
 308 ```
 309 ### AppUpdateURL
 310
 311 Change the URL for application update if you are providing Firefox updates from a custom update server.
 312
 313 **Compatibility:** Firefox 62, Firefox ESR 60.2\
 314 **CCK2 Equivalent:** N/A\
 315 **Preferences Affected:** `app.update.url`
 316
 317 #### Windows (GPO)
 318 ```
 319 Software\Policies\Mozilla\Firefox\AppUpdateURL = "https://yoursite.com"
 320 ```
 321 #### Windows (Intune)
 322 OMA-URI:
 323 ```
 324 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/AppUpdateURL
 325 ```
 326 Value (string):
 327 ```
 328 <enabled/>
 329 <data id="AppUpdateURL" value="https://yoursite.com"/>
 330 ```
 331 #### macOS
 332 ```
 333 <dict>
 334   <key>AppUpdateURL</key>
 335   <string>https://yoursite.com</string>
 336 </dict>
 337 ```
 338 #### policies.json
 339 ```
 340 {
 341   "policies": {
 342     "AppUpdateURL": "https://yoursite.com"
 343   }
 344 }
 345 ```
 346 ### Authentication
 347
 348 Configure sites that support integrated authentication.
 349
 350 See [Integrated authentication](https://htmlpreview.github.io/?https://github.com/mdn/archived-content/blob/main/files/en-us/mozilla/integrated_authentication/raw.html) for more information.
 351
 352 `PrivateBrowsing` enables integrated authentication in private browsing.
 353
 354 **Compatibility:** Firefox 60, Firefox ESR 60 (AllowNonFQDN added in 62/60.2, AllowProxies added in 70/68.2, Locked added in 71/68.3, PrivateBrowsing added in 77/68.9)\
 355 **CCK2 Equivalent:** N/A\
 356 **Preferences Affected:** `network.negotiate-auth.trusted-uris`,`network.negotiate-auth.delegation-uris`,`network.automatic-ntlm-auth.trusted-uris`,`network.automatic-ntlm-auth.allow-non-fqdn`,`network.negotiate-auth.allow-non-fqdn`,`network.automatic-ntlm-auth.allow-proxies`,`network.negotiate-auth.allow-proxies`,`network.auth.private-browsing-sso`
 357
 358 #### Windows (GPO)
 359 ```
 360 Software\Policies\Mozilla\Firefox\Authentication\SPNEGO\1 = "mydomain.com"
 361 Software\Policies\Mozilla\Firefox\Authentication\SPNEGO\2 = "https://myotherdomain.com"
 362 Software\Policies\Mozilla\Firefox\Authentication\Delegated\1 = "mydomain.com"
 363 Software\Policies\Mozilla\Firefox\Authentication\Delegated\2 = "https://myotherdomain.com"
 364 Software\Policies\Mozilla\Firefox\Authentication\NTLM\1 = "mydomain.com"
 365 Software\Policies\Mozilla\Firefox\Authentication\NTLM\2 = "https://myotherdomain.com"
 366 Software\Policies\Mozilla\Firefox\Authentication\AllowNonFQDN\SPNEGO = 0x1 | 0x0
 367 Software\Policies\Mozilla\Firefox\Authentication\AllowNonFQDN\NTLM = 0x1 | 0x0
 368 Software\Policies\Mozilla\Firefox\Authentication\AllowProxies\SPNEGO = 0x1 | 0x0
 369 Software\Policies\Mozilla\Firefox\Authentication\AllowProxies\NTLM = 0x1 | 0x0
 370 Software\Policies\Mozilla\Firefox\Authentication\Locked = 0x1 | 0x0
 371 Software\Policies\Mozilla\Firefox\Authentication\PrivateBrowsing = 0x1 | 0x0
 372 ```
 373 #### Windows (Intune)
 374 OMA-URI:
 375 ```
 376 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Authentication/Authentication_SPNEGO
 377 ```
 378 Value (string):
 379 ```
 380 <enabled/>
 381 <data id="Authentication" value="1&#xF000;mydomain&#xF000;2&#xF000;https://myotherdomain.com"/>
 382 ```
 383 OMA-URI:
 384 ```
 385 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Authentication/Authentication_Delegated
 386 ```
 387 Value (string):
 388 ```
 389 <enabled/>
 390 <data id="Authentication" value="1&#xF000;mydomain&#xF000;2&#xF000;https://myotherdomain.com"/>
 391 ```
 392 OMA-URI:
 393 ```
 394 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Authentication/Authentication_NTLM
 395 ```
 396 Value (string):
 397 ```
 398 <enabled/>
 399 <data id="Authentication" value="1&#xF000;mydomain&#xF000;2&#xF000;https://myotherdomain.com"/>
 400 ```
 401 OMA-URI:
 402 ```
 403 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Authentication/Authentication_AllowNonFQDN
 404 ```
 405 Value (string):
 406 ```
 407 <enabled/>
 408 <data id="Authentication_AllowNonFQDN_NTLM" value="true | false"/>
 409 <data id="Authentication_AllowNonFQDN_SPNEGO" value="true | false"/>
 410 ```
 411 OMA-URI:
 412 ```
 413 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Authentication/Authentication_Locked
 414 ```
 415 Value (string):
 416 ```
 417 <enabled/> or <disabled/>
 418 ```
 419 OMA-URI:
 420 ```
 421 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Authentication/Authentication_PrivateBrowsing
 422 ```
 423 Value (string):
 424 ```
 425 <enabled/> or <disabled/>
 426 ```
 427 #### macOS
 428 ```
 429 <dict>
 430   <key>Authentication</key>
 431   <dict>
 432     <key>SPNEGO</key>
 433     <array>
 434       <string>mydomain.com</string>
 435       <string>https://myotherdomain.com</string>
 436     </array>
 437     <key>Delegated</key>
 438     <array>
 439       <string>mydomain.com</string>
 440       <string>https://myotherdomain.com</string>
 441     </array>
 442     <key>NTLM</key>
 443     <array>
 444       <string>mydomain.com</string>
 445       <string>https://myotherdomain.com</string>
 446     </array>
 447     <key>AllowNonFQDN</key>
 448       <dict>
 449       <key>SPNEGO</key>
 450       <true/> | <false/>
 451       <key>NTLM</key>
 452       <true/> | <false/>
 453     </dict>
 454     <key>AllowProxies</key>
 455       <dict>
 456       <key>SPNEGO</key>
 457       <true/> | <false/>
 458       <key>NTLM</key>
 459       <true/> | <false/>
 460     </dict>
 461     <key>Locked</key>
 462     <true/> | <false/>
 463     <key>PrivateBrowsing</key>
 464     <true/> | <false/>
 465   </dict>
 466 </dict>
 467 ```
 468 #### policies.json
 469 ```
 470 {
 471   "policies": {
 472     "Authentication": {
 473       "SPNEGO": ["mydomain.com", "https://myotherdomain.com"],
 474       "Delegated": ["mydomain.com", "https://myotherdomain.com"],
 475       "NTLM": ["mydomain.com", "https://myotherdomain.com"],
 476       "AllowNonFQDN": {
 477         "SPNEGO": true | false,
 478         "NTLM": true | false
 479       },
 480       "AllowProxies": {
 481         "SPNEGO": true | false,
 482         "NTLM": true | false
 483       },
 484       "Locked": true | false,
 485       "PrivateBrowsing": true | false
 486     }
 487   }
 488 }
 489 ```
 490 ### AutoLaunchProtocolsFromOrigins
 491 Define a list of external protocols that can be used from listed origins without prompting the user. The origin is the scheme plus the hostname.
 492
 493 The syntax of this policy is exactly the same as the [Chrome AutoLaunchProtocolsFromOrigins policy](https://cloud.google.com/docs/chrome-enterprise/policies/?policy=AutoLaunchProtocolsFromOrigins) except that you can only use valid origins (not just hostnames). This also means that you cannot specify an asterisk for all origins.
 494
 495 The schema is:
 496 ```
 497 {
 498  "items": {
 499   "properties": {
 500    "allowed_origins": {
 501     "items": {
 502      "type": "string"
 503     },
 504     "type": "array"
 505    },
 506    "protocol": {
 507     "type": "string"
 508    }
 509   },
 510   "required": [
 511    "protocol",
 512    "allowed_origins"
 513   ],
 514   "type": "object"
 515  },
 516  "type": "array"
 517 }
 518 ```
 519 **Compatibility:** Firefox 90, Firefox ESR 78.12\
 520 **CCK2 Equivalent:** N/A\
 521 **Preferences Affected:** N/A
 522
 523 #### Windows (GPO)
 524 Software\Policies\Mozilla\Firefox\AutoLaunchProtocolsFromOrigins (REG_MULTI_SZ) =
 525 ```
 526 [
 527   {
 528     "protocol": "zoommtg",
 529     "allowed_origins": [
 530       "https://somesite.zoom.us"
 531     ]
 532   }
 533 ]
 534 ```
 535 #### Windows (Intune)
 536 OMA-URI:
 537 ```
 538 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/AutoLaunchProtocolsFromOrigins
 539 ```
 540 Value (string):
 541 ```
 542 <enabled/>
 543 <data id="JSON" value='
 544 [
 545   {
 546     "protocol": "zoommtg",
 547     "allowed_origins": [
 548       "https://somesite.zoom.us"
 549     ]
 550   }
 551 ]'/>
 552 ```
 553 #### macOS
 554 ```
 555 <dict>
 556   <key>AutoLaunchProtocolsFromOrigins</key>
 557   <array>
 558     <dict>
 559       <key>protocol</key>
 560       <string>zoommtg</string>
 561       <key>allowed_origins</key>
 562       <array>
 563         <string>https://somesite.zoom.us</string>
 564       </array>
 565     </dict>
 566   </array>
 567 </dict>
 568 ```
 569 #### policies.json
 570 ```
 571 {
 572   "policies": {
 573     "AutoLaunchProtocolsFromOrigins": [{
 574       "protocol": "zoommtg",
 575       "allowed_origins": [
 576         "https://somesite.zoom.us"
 577       ]
 578     }]
 579   }
 580 }
 581 ```
 582 ### BackgroundAppUpdate
 583
 584 Enable or disable **automatic** application update **in the background**, when the application is not running.
 585
 586 If set to true, application updates may be installed (without user approval) in the background, even when the application is not running. The operating system might still require approval.
 587
 588 If set to false, the application will not try to install updates when the application is not running.
 589
 590 If you have disabled updates via `DisableAppUpdate` or disabled automatic updates via `AppAutoUpdate`, this policy has no effect.
 591
 592 **Compatibility:** Firefox 90 (Windows only)\
 593 **CCK2 Equivalent:** N/A\
 594 **Preferences Affected:** `app.update.background.enabled`
 595
 596 #### Windows (GPO)
 597 ```
 598 Software\Policies\Mozilla\Firefox\BackgroundAppUpdate = 0x1 | 0x0
 599 ```
 600 #### Windows (Intune)
 601 OMA-URI:
 602 ```
 603 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/BackgroundAppUpdate
 604 ```
 605 Value (string):
 606 ```
 607 <enabled/> or <disabled/>
 608 ```
 609 #### macOS
 610 ```
 611 <dict>
 612   <key>BackgroundAppUpdate</key>
 613   <true/> | <false/>
 614 </dict>
 615 ```
 616 #### policies.json
 617 ```
 618 {
 619   "policies": {
 620     "BackgroundAppUpdate": true | false
 621   }
 622 }
 623 ```
 624 ### BlockAboutAddons
 625
 626 Block access to the Add-ons Manager (about:addons).
 627
 628 **Compatibility:** Firefox 60, Firefox ESR 60\
 629 **CCK2 Equivalent:** `disableAddonsManager`\
 630 **Preferences Affected:** N/A
 631
 632 #### Windows (GPO)
 633 ```
 634 Software\Policies\Mozilla\Firefox\BlockAboutAddons = 0x1 | 0x0
 635 ```
 636 #### Windows (Intune)
 637 OMA-URI:
 638 ```
 639 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/BlockAboutAddons
 640 ```
 641 Value (string):
 642 ```
 643 <enabled/> or <disabled/>
 644 ```
 645 #### macOS
 646 ```
 647 <dict>
 648   <key>BlockAboutAddons</key>
 649   <true/> | <false/>
 650 </dict>
 651 ```
 652 #### policies.json
 653 ```
 654 {
 655   "policies": {
 656     "BlockAboutAddons": true | false
 657   }
 658 }
 659 ```
 660 ### BlockAboutConfig
 661
 662 Block access to about:config.
 663
 664 **Compatibility:** Firefox 60, Firefox ESR 60\
 665 **CCK2 Equivalent:** `disableAboutConfig`\
 666 **Preferences Affected:** N/A
 667
 668 #### Windows (GPO)
 669 ```
 670 Software\Policies\Mozilla\Firefox\BlockAboutConfig = 0x1 | 0x0
 671 ```
 672 #### Windows (Intune)
 673 OMA-URI:
 674 ```
 675 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/BlockAboutConfig
 676 ```
 677 Value (string):
 678 ```
 679 <enabled/> or <disabled/>
 680 ```
 681 #### macOS
 682 ```
 683 <dict>
 684   <key>BlockAboutConfig</key>
 685   <true/> | <false/>
 686 </dict>
 687 ```
 688 #### policies.json
 689 ```
 690 {
 691   "policies": {
 692     "BlockAboutConfig": true | false
 693   }
 694 }
 695 ```
 696 ### BlockAboutProfiles
 697
 698 Block access to About Profiles (about:profiles).
 699
 700 **Compatibility:** Firefox 60, Firefox ESR 60\
 701 **CCK2 Equivalent:** `disableAboutProfiles`\
 702 **Preferences Affected:** N/A
 703
 704 #### Windows (GPO)
 705 ```
 706 Software\Policies\Mozilla\Firefox\BlockAboutProfiles = 0x1 | 0x0
 707 ```
 708 #### Windows (Intune)
 709 OMA-URI:
 710 ```
 711 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/BlockAboutProfiles
 712 ```
 713 Value (string):
 714 ```
 715 <enabled/> or <disabled/>
 716 ```
 717 #### macOS
 718 ```
 719 <dict>
 720   <key>BlockAboutProfiles</key>
 721   <true/> | <false/>
 722 </dict>
 723 ```
 724 #### policies.json
 725 ```
 726 {
 727   "policies": {
 728     "BlockAboutProfiles": true | false
 729   }
 730 }
 731 ```
 732 ### BlockAboutSupport
 733
 734 Block access to Troubleshooting Information (about:support).
 735
 736 **Compatibility:** Firefox 60, Firefox ESR 60\
 737 **CCK2 Equivalent:** `disableAboutSupport`\
 738 **Preferences Affected:** N/A
 739
 740 #### Windows (GPO)
 741 ```
 742 Software\Policies\Mozilla\Firefox\BlockAboutSupport = 0x1 | 0x0
 743 ```
 744 #### Windows (Intune)
 745 OMA-URI:
 746 ```
 747 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/BlockAboutSupport
 748 ```
 749 Value (string):
 750 ```
 751 <enabled/> or <disabled/>
 752 ```
 753 #### macOS
 754 ```
 755 <dict>
 756   <key>BlockAboutSupport</key>
 757   <true/> | <false/>
 758 </dict>
 759 ```
 760 #### policies.json
 761 ```
 762 {
 763   "policies": {
 764     "BlockAboutSupport": true | false
 765   }
 766 }
 767 ```
 768 ### Bookmarks
 769
 770 Note: [`ManagedBookmarks`](#managedbookmarks) is the new recommended way to add bookmarks. This policy will continue to be supported.
 771
 772 Add bookmarks in either the bookmarks toolbar or menu. Only `Title` and `URL` are required. If `Placement` is not specified, the bookmark will be placed on the toolbar. If `Folder` is specified, it is automatically created and bookmarks with the same folder name are grouped together.
 773
 774 If you want to clear all bookmarks set with this policy, you can set the value to an empty array (```[]```). This can be on Windows via the new Bookmarks (JSON) policy available with GPO and Intune.
 775
 776 **Compatibility:** Firefox 60, Firefox ESR 60\
 777 **CCK2 Equivalent:** `bookmarks.toolbar`,`bookmarks.menu`\
 778 **Preferences Affected:** N/A
 779
 780 #### Windows (GPO)
 781 ```
 782 Software\Policies\Mozilla\Firefox\Bookmarks\1\Title = "Example"
 783 Software\Policies\Mozilla\Firefox\Bookmarks\1\URL = "https://example.com"
 784 Software\Policies\Mozilla\Firefox\Bookmarks\1\Favicon = "https://example.com/favicon.ico"
 785 Software\Policies\Mozilla\Firefox\Bookmarks\1\Placement = "toolbar" | "menu"
 786 Software\Policies\Mozilla\Firefox\Bookmarks\1\Folder = "FolderName"
 787
 788 Software\Policies\Mozilla\Firefox\Bookmarks (REG_MULTI_SZ) =
 789 ```
 790 []
 791 ```
 792
 793 ```
 794 #### Windows (Intune)
 795 OMA-URI:
 796 ```
 797 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Bookmarks/Bookmark01
 798 ```
 799 Value (string):
 800 ```
 801 <enabled/>
 802 <data id="BookmarkTitle" value="Example"/>
 803 <data id="BookmarkURL" value="https://example.com"/>
 804 <data id="BookmarkFavicon" value="https://example.com/favicon.ico"/>
 805 <data id="BookmarkPlacement" value="toolbar | menu"/>
 806 <data id="BookmarkFolder" value="FolderName"/>
 807 ```
 808 OMA-URI:
 809 ```
 810 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/Bookmarks
 811 ```
 812 Value (string):
 813 ```
 814 <enabled/>
 815 <data id="JSON" value='[]'/>
 816 ```
 817 #### macOS
 818 ```
 819 <dict>
 820   <key>Bookmarks</key>
 821   <array>
 822     <dict>
 823       <key>Title</key>
 824       <string>Example</string>
 825       <key>URL</key>
 826       <string>https://example.com</string>
 827       <key>Favicon</key>
 828       <string>https://example.com/favicon.ico</string>
 829       <key>Placement</key>
 830       <string>toolbar | menu</string>
 831       <key>Folder</key>
 832       <string>FolderName</string>
 833     </dict>
 834   </array>
 835 </dict>
 836 ```
 837 #### policies.json
 838 ```
 839 {
 840   "policies": {
 841     "Bookmarks": [
 842       {
 843         "Title": "Example",
 844         "URL": "https://example.com",
 845         "Favicon": "https://example.com/favicon.ico",
 846         "Placement": "toolbar" | "menu",
 847         "Folder": "FolderName"
 848       }
 849     ]
 850   }
 851 }
 852 ```
 853 ### CaptivePortal
 854 Enable or disable the detection of captive portals.
 855
 856 **Compatibility:** Firefox 67, Firefox ESR 60.7\
 857 **CCK2 Equivalent:** N/A\
 858 **Preferences Affected:** `network.captive-portal-service.enabled`
 859
 860 #### Windows (GPO)
 861 ```
 862 Software\Policies\Mozilla\Firefox\CaptivePortal = 0x1 | 0x0
 863 ```
 864 #### Windows (Intune)
 865 OMA-URI:
 866 ```
 867 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/CaptivePortal
 868 ```
 869 Value (string):
 870 ```
 871 <enabled/> or <disabled/>
 872 ```
 873 #### macOS
 874 ```
 875 <dict>
 876   <key>CaptivePortal</key>
 877   <true/> | <false/>
 878 </dict>
 879 ```
 880 #### policies.json
 881 ```
 882 {
 883   "policies": {
 884     "CaptivePortal": true | false
 885   }
 886 }
 887 ```
 888 ### Certificates
 889
 890 ### Certificates | ImportEnterpriseRoots
 891
 892 Trust certificates that have been added to the operating system certificate store by a user or administrator.
 893
 894 Note: This policy only works on Windows and macOS. For Linux discussion, see [bug 1600509](https://bugzilla.mozilla.org/show_bug.cgi?id=1600509).
 895
 896 See https://support.mozilla.org/kb/setting-certificate-authorities-firefox for more detail.
 897
 898 **Compatibility:** Firefox 60, Firefox ESR 60 (macOS support in Firefox 63, Firefox ESR 68)\
 899 **CCK2 Equivalent:** N/A\
 900 **Preferences Affected:** `security.enterprise_roots.enabled`
 901
 902 #### Windows (GPO)
 903 ```
 904 Software\Policies\Mozilla\Firefox\Certificates\ImportEnterpriseRoots = 0x1 | 0x0
 905 ```
 906 #### Windows (Intune)
 907 OMA-URI:
 908 ```
 909 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Certificates/Certificates_ImportEnterpriseRoots
 910 ```
 911 Value (string):
 912 ```
 913 <enabled/> or <disabled/>
 914 ```
 915 #### macOS
 916 ```
 917 <dict>
 918   <key>Certificates</key>
 919   <dict>
 920     <key>ImportEnterpriseRoots</key>
 921     <true/> | <false/>
 922   </dict>
 923 </dict>
 924 ```
 925 #### policies.json
 926 ```
 927 {
 928   "policies": {
 929     "Certificates": {
 930       "ImportEnterpriseRoots": true | false
 931     }
 932   }
 933 }
 934 ```
 935 ### Certificates | Install
 936
 937 Install certificates into the Firefox certificate store. If only a filename is specified, Firefox searches for the file in the following locations:
 938
 939 - Windows
 940   - %USERPROFILE%\AppData\Local\Mozilla\Certificates
 941   - %USERPROFILE%\AppData\Roaming\Mozilla\Certificates
 942 - macOS
 943   - /Library/Application Support/Mozilla/Certificates
 944   - ~/Library/Application Support/Mozilla/Certificates
 945 - Linux
 946   - /usr/lib/mozilla/certificates
 947   - /usr/lib64/mozilla/certificates
 948   - ~/.mozilla/certificates
 949
 950 Starting with Firefox 65, Firefox 60.5 ESR, a fully qualified path can be used, including UNC paths. You should use the native path style for your operating system. We do not support using %USERPROFILE% or other environment variables on Windows.
 951
 952 If you are specifying the path in the policies.json file on Windows, you need to escape your backslashes (`\\`) which means that for UNC paths, you need to escape both (`\\\\`). If you use group policy, you only need one backslash.
 953
 954 Certificates are installed using the trust string `CT,CT,`.
 955
 956 Binary (DER) and ASCII (PEM) certificates are both supported.
 957
 958 **Compatibility:** Firefox 64, Firefox ESR 64\
 959 **CCK2 Equivalent:** `certs.ca`\
 960 **Preferences Affected:** N/A
 961
 962 #### Windows (GPO)
 963 ```
 964 Software\Policies\Mozilla\Firefox\Certificates\Install\1 = "cert1.der"
 965 Software\Policies\Mozilla\Firefox\Certificates\Install\2 = "C:\Users\username\cert2.pem"
 966 ```
 967 #### Windows (Intune)
 968 OMA-URI:
 969 ```
 970 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Certificates/Certificates_Install
 971 ```
 972 Value (string):
 973 ```
 974 <enabled/>
 975 <data id="Certificates_Install" value="1&#xF000;cert1.der&#xF000;2&#xF000;C:\Users\username\cert2.pem"/>
 976 ```
 977 #### macOS
 978 ```
 979 <dict>
 980   <key>Certificates</key>
 981   <dict>
 982     <key>Install</key>
 983     <array>
 984       <string>cert1.der</string>
 985       <string>/Users/username/cert2.pem</string>
 986     </array>
 987   </dict>
 988 </dict>
 989 ```
 990 #### policies.json
 991 ```
 992 {
 993   "policies": {
 994     "Certificates": {
 995       "Install": ["cert1.der", "/home/username/cert2.pem"]
 996     }
 997   }
 998 }
 999 ```
1000 ### Containers
1001 Set policies related to [containers](https://addons.mozilla.org/firefox/addon/multi-account-containers/).
1002
1003 Currently you can set the initial set of containers.
1004
1005 For each container, you can specify the name, icon, and color.
1006
1007 | Name | Description |
1008 | --- | --- |
1009 | `name`| Name of container
1010 | `icon` | Can be `fingerprint`, `briefcase`, `dollar`, `cart`, `vacation`, `gift`, `food`, `fruit`, `pet`, `tree`, `chill`, `circle`, `fence`
1011 | `color` | Can be `blue`, `turquoise`, `green`, `yellow`, `orange`, `red`, `pink`, `purple`, `toolbar`
1012
1013 **Compatibility:** Firefox 113\
1014 **CCK2 Equivalent:** N/A\
1015 **Preferences Affected:** N/A
1016
1017 #### Windows (GPO)
1018 Software\Policies\Mozilla\Firefox\Containers (REG_MULTI_SZ) =
1019 ```
1020 {
1021   "Default": [
1022     {
1023       "name": "My container",
1024       "icon": "pet",
1025       "color": "turquoise"
1026     }
1027   ]
1028 }
1029 ```
1030 #### Windows (Intune)
1031 OMA-URI:
1032 ```
1033 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/Containers
1034 ```
1035 Value (string):
1036 ```
1037 <enabled/>
1038 <data id="JSON" value='
1039 {
1040   "Default": [
1041     {
1042       "name": "My container",
1043       "icon": "pet",
1044       "color": "turquoise"
1045     }
1046   ]
1047 }
1048 '/>
1049 ```
1050 #### macOS
1051 ```
1052 <dict>
1053   <key>Default</key>
1054   <dict>
1055     <key>Containers</key>
1056     <array>
1057       <dict>
1058         <key>name</key>
1059         <string>My container</string>
1060         <key>icon</key>
1061         <string>pet</string>
1062         <key>color</key>
1063         <string>turquoise</string>
1064       </dict>
1065     </array>
1066   </dict>
1067 </dict>
1068 ```
1069 #### policies.json
1070 ```
1071 {
1072   "policies": {
1073     "Containers": {
1074       "Default": [
1075         {
1076           "name": "My container",
1077           "icon": "pet",
1078           "color": "turquoise"
1079         }
1080       ]
1081     }
1082   }
1083 }
1084 ```
1085 ### Cookies
1086 Configure cookie preferences.
1087
1088 `Allow` is a list of origins (not domains) where cookies are always allowed. You must include http or https.
1089
1090 `AllowSession` is a list of origins (not domains) where cookies are only allowed for the current session. You must include http or https.
1091
1092 `Block` is a list of origins (not domains) where cookies are always blocked. You must include http or https.
1093
1094 `Behavior` sets the default behavior for cookies based on the values below.
1095
1096 `BehaviorPrivateBrowsing` sets the default behavior for cookies in private browsing based on the values below.
1097
1098 | Value | Description
1099 | --- | --- |
1100 | accept | Accept all cookies
1101 | reject-foreign | Reject third party cookies
1102 | reject | Reject all cookies
1103 | limit-foreign | Reject third party cookies for sites you haven't visited
1104 | reject-tracker | Reject cookies for known trackers (default)
1105 | reject-tracker-and-partition-foreign | Reject cookies for known trackers and partition third-party cookies (Total Cookie Protection) (default for private browsing)
1106
1107 `Default` (Deprecated) determines whether cookies are accepted at all.
1108
1109 `AcceptThirdParty` (Deprecated) determines how third-party cookies are handled.
1110
1111 `ExpireAtSessionEnd` determines when cookies expire.
1112
1113 `RejectTracker` (Deprecated) only rejects cookies for trackers.
1114
1115 `Locked` prevents the user from changing cookie preferences.
1116
1117 **Compatibility:** Firefox 60, Firefox ESR 60 (RejectTracker added in Firefox 63, AllowSession added in Firefox 79/78.1, Behavior added in Firefox 95/91.4)\
1118 **CCK2 Equivalent:** N/A\
1119 **Preferences Affected:** `network.cookie.cookieBehavior`, `network.cookie.cookieBehavior.pbmode`, `network.cookie.lifetimePolicy`
1120
1121 #### Windows (GPO)
1122 ```
1123 Software\Policies\Mozilla\Firefox\Cookies\Allow\1 = "https://example.com"
1124 Software\Policies\Mozilla\Firefox\Cookies\AllowSession\1 = "https://example.edu"
1125 Software\Policies\Mozilla\Firefox\Cookies\Block\1 = "https://example.org"
1126 Software\Policies\Mozilla\Firefox\Cookies\Default = 0x1 | 0x0
1127 Software\Policies\Mozilla\Firefox\Cookies\AcceptThirdParty = "always" | "never" | "from-visited"
1128 Software\Policies\Mozilla\Firefox\Cookies\ExpireAtSessionEnd = 0x1 | 0x0
1129 Software\Policies\Mozilla\Firefox\Cookies\RejectTracker = 0x1 | 0x0
1130 Software\Policies\Mozilla\Firefox\Cookies\Behavior = "accept" | "reject-foreign" | "reject" | "limit-foreign" | "reject-tracker" | "reject-tracker-and-partition-foreign"
1131 Software\Policies\Mozilla\Firefox\Cookies\BehaviorPrivateBrowsing = "accept" | "reject-foreign" | "reject" | "limit-foreign" | "reject-tracker" | "reject-tracker-and-partition-foreign"
1132 Software\Policies\Mozilla\Firefox\Cookies\Locked = 0x1 | 0x0
1133 ```
1134 #### Windows (Intune)
1135 OMA-URI:
1136 ```
1137 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Cookies/Cookies_Allow
1138 ```
1139 Value (string):
1140 ```
1141 <enabled/>
1142 <data id="Permissions" value="1&#xF000;https://example.com"/>
1143 ```
1144 OMA-URI:
1145 ```
1146 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Cookies/Cookies_AllowSession
1147 ```
1148 Value (string):
1149 ```
1150 <enabled/>
1151 <data id="Permissions" value="1&#xF000;https://example.edu"/>
1152 ```
1153 OMA-URI:
1154 ```
1155 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Cookies/Cookies_Block
1156 ```
1157 Value (string):
1158 ```
1159 <enabled/>
1160 <data id="Permissions" value="1&#xF000;https://example.org"/>
1161 ```
1162 OMA-URI:
1163 ```
1164 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Cookies/Cookies_Default
1165 ```
1166 Value (string):
1167 ```
1168 <enabled/> or <disabled/>
1169 ```
1170 OMA-URI:
1171 ```
1172 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Cookies/Cookies_AcceptThirdParty
1173 ```
1174 Value (string):
1175 ```
1176 <enabled/>
1177 <data id="Cookies_AcceptThirdParty" value="always | never | from-visited"/>
1178 ```
1179 OMA-URI:
1180 ```
1181 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Cookies/Cookies_ExpireAtSessionEnd
1182 ```
1183 Value (string):
1184 ```
1185 <enabled/> or <disabled/>
1186 ```
1187 OMA-URI:
1188 ```
1189 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Cookies/Cookies_RejectTracker
1190 ```
1191 Value (string):
1192 ```
1193 <enabled/> or <disabled/>
1194 ```
1195 OMA-URI:
1196 ```
1197 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Cookies/Cookies_Locked
1198 ```
1199 Value (string):
1200 ```
1201 <enabled/> or <disabled/>
1202 ```
1203 OMA-URI:
1204 ```
1205 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Cookies/Cookies_Behavior
1206 ```
1207 Value (string):
1208 ```
1209 <enabled/>
1210 <data id="Cookies_Behavior" value="accept | reject-foreign | reject | limit-foreign | reject-tracker | reject-tracker-and-partition-foreign"/>
1211 ```
1212 OMA-URI:
1213 ```
1214 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Cookies/Cookies_BehaviorPrivateBrowsing
1215 ```
1216 Value (string):
1217 ```
1218 <enabled/>
1219 <data id="Cookies_BehaviorPrivateBrowsing" value="accept | reject-foreign | reject | limit-foreign | reject-tracker | reject-tracker-and-partition-foreign"/>
1220 ```
1221 #### macOS
1222 ```
1223 <dict>
1224   <key>Cookies</key>
1225   <dict>
1226     <key>Allow</key>
1227     <array>
1228       <string>http://example.com</string>
1229     </array>
1230     <key>AllowSession</key>
1231     <array>
1232       <string>http://example.edu</string>
1233     </array>
1234     <key>Block</key>
1235     <array>
1236       <string>http://example.org</string>
1237     </array>
1238     <key>Default</key>
1239     <true/> | <false/>
1240     <key>AcceptThirdParty</key>
1241     <string>always | never | from-visited</string>
1242     <key>ExpireAtSessionEnd</key>
1243     <true/> | <false/>
1244     <key>RejectTracker</key>
1245     <true/> | <false/>
1246     <key>Locked</key>
1247     <true/> | <false/>
1248     <key>Behavior</key>
1249     <string>accept | reject-foreign | reject | limit-foreign | reject-tracker | reject-tracker-and-partition-foreign</string>
1250     <key>BehaviorPrivateBrowsing</key>
1251     <string>accept | reject-foreign | reject | limit-foreign | reject-tracker | reject-tracker-and-partition-foreign</string>
1252   </dict>
1253 </dict>
1254 ```
1255 #### policies.json
1256 ```
1257 {
1258   "policies": {
1259     "Cookies": {
1260       "Allow": ["http://example.org/"],
1261       "AllowSession": ["http://example.edu/"],
1262       "Block": ["http://example.edu/"],
1263       "Default": true | false,
1264       "AcceptThirdParty": "always" | "never" | "from-visited",
1265       "ExpireAtSessionEnd": true | false,
1266       "RejectTracker": true | false,
1267       "Locked": true | false,
1268       "Behavior": "accept" | "reject-foreign" | "reject" | "limit-foreign" | "reject-tracker" | "reject-tracker-and-partition-foreign",
1269       "BehaviorPrivateBrowsing": "accept" | "reject-foreign" | "reject" | "limit-foreign" | "reject-tracker" | "reject-tracker-and-partition-foreign",
1270     }
1271   }
1272 }
1273 ```
1274 ### DefaultDownloadDirectory
1275 Set the default download directory.
1276
1277 You can use ${home} for the native home directory.
1278
1279 **Compatibility:** Firefox 68, Firefox ESR 68\
1280 **CCK2 Equivalent:** N/A\
1281 **Preferences Affected:** `browser.download.dir`, `browser.download.folderList`
1282
1283 #### Windows (GPO)
1284 ```
1285 Software\Policies\Mozilla\Firefox\DefaultDownloadDirectory = "${home}\Downloads"
1286 ```
1287 #### Windows (Intune)
1288 OMA-URI:
1289 ```
1290 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DefaultDownloadDirectory
1291 ```
1292 Value (string):
1293 ```
1294 <enabled/>
1295 <data id="Preferences_String" value="${home}\Downloads"/>
1296 ```
1297 #### macOS
1298 ```
1299 <dict>
1300   <key>DefaultDownloadDirectory</key>
1301   <string>${home}/Downloads</string>
1302 </dict>
1303 ```
1304 #### policies.json (macOS and Linux)
1305 ```
1306 {
1307   "policies": {
1308     "DefaultDownloadDirectory": "${home}/Downloads"
1309   }
1310 }
1311 ```
1312 #### policies.json (Windows)
1313 ```
1314 {
1315   "policies": {
1316     "DefaultDownloadDirectory": "${home}\\Downloads"
1317   }
1318 }
1319 ```
1320 ### DisableAppUpdate
1321 Turn off application updates within Firefox.
1322
1323 **Compatibility:** Firefox 60, Firefox ESR 60\
1324 **CCK2 Equivalent:** `disableFirefoxUpdates`\
1325 **Preferences Affected:** N/A
1326
1327 #### Windows (GPO)
1328 ```
1329 Software\Policies\Mozilla\Firefox\DisableAppUpdate = 0x1 | 0x0
1330 ```
1331 #### Windows (Intune)
1332 OMA-URI:
1333 ```
1334 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableAppUpdate
1335 ```
1336 Value (string):
1337 ```
1338 <enabled/> or <disabled/>
1339 ```
1340 #### macOS
1341 ```
1342 <dict>
1343   <key>DisableAppUpdate</key>
1344   <true/> | <false/>
1345 </dict>
1346 ```
1347 #### policies.json
1348 ```
1349 {
1350   "policies": {
1351     "DisableAppUpdate": true | false
1352   }
1353 }
1354 ```
1355 ### DisableBuiltinPDFViewer
1356 Disable the built in PDF viewer. PDF files are downloaded and sent externally.
1357
1358 **Compatibility:** Firefox 60, Firefox ESR 60\
1359 **CCK2 Equivalent:** `disablePDFjs`\
1360 **Preferences Affected:** `pdfjs.disabled`
1361
1362 #### Windows (GPO)
1363 ```
1364 Software\Policies\Mozilla\Firefox\DisableBuiltinPDFViewer = 0x1 | 0x0
1365 ```
1366 #### Windows (Intune)
1367 OMA-URI:
1368 ```
1369 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableBuiltinPDFViewer
1370 ```
1371 Value (string):
1372 ```
1373 <enabled/> or <disabled/>
1374 ```
1375 #### macOS
1376 ```
1377 <dict>
1378   <key>DisableBuiltinPDFViewer</key>
1379   <true/> | <false/>
1380 </dict>
1381 ```
1382 #### policies.json
1383 ```
1384 {
1385   "policies": {
1386     "DisableBuiltinPDFViewer": true | false
1387   }
1388 }
1389 ```
1390 ### DisabledCiphers
1391 Disable specific cryptographic ciphers, listed below.
1392
1393 ```
1394 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
1395 TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
1396 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
1397 TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
1398 TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
1399 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
1400 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
1401 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
1402 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
1403 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
1404 TLS_DHE_RSA_WITH_AES_128_CBC_SHA
1405 TLS_DHE_RSA_WITH_AES_256_CBC_SHA
1406 TLS_RSA_WITH_AES_128_GCM_SHA256
1407 TLS_RSA_WITH_AES_256_GCM_SHA384
1408 TLS_RSA_WITH_AES_128_CBC_SHA
1409 TLS_RSA_WITH_AES_256_CBC_SHA
1410 TLS_RSA_WITH_3DES_EDE_CBC_SHA
1411 ```
1412
1413 **Preferences Affected:** `security.ssl3.ecdhe_rsa_aes_128_gcm_sha256`, `security.ssl3.ecdhe_ecdsa_aes_128_gcm_sha256`, `security.ssl3.ecdhe_ecdsa_chacha20_poly1305_sha256`, `security.ssl3.ecdhe_rsa_chacha20_poly1305_sha256`, `security.ssl3.ecdhe_ecdsa_aes_256_gcm_sha384`, `security.ssl3.ecdhe_rsa_aes_256_gcm_sha384`, `security.ssl3.ecdhe_rsa_aes_128_sha`, `security.ssl3.ecdhe_ecdsa_aes_128_sha`, `security.ssl3.ecdhe_rsa_aes_256_sha`, `security.ssl3.ecdhe_ecdsa_aes_256_sha`, `security.ssl3.dhe_rsa_aes_128_sha`, `security.ssl3.dhe_rsa_aes_256_sha`, `security.ssl3.rsa_aes_128_gcm_sha256`, `security.ssl3.rsa_aes_256_gcm_sha384`, `security.ssl3.rsa_aes_128_sha`, `security.ssl3.rsa_aes_256_sha`, `security.ssl3.deprecated.rsa_des_ede3_sha`
1414
1415 ---
1416 **Note:**
1417
1418 This policy was updated in Firefox 78 to allow enabling ciphers as well. Setting the value to true disables the cipher, setting the value to false enables the cipher. Previously setting the value to true or false disabled the cipher.
1419
1420 ---
1421 **Compatibility:** Firefox 76, Firefox ESR 68.8 (TLS_RSA_WITH_AES_128_GCM_SHA256 and TLS_RSA_WITH_AES_256_GCM_SHA384 were added in Firefox 78, TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA, TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA, TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA38, TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256, TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, and TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 were added in Firefox 97 and Firefox 91.6)\
1422 **CCK2 Equivalent:** N/A\
1423 **Preferences Affected:** N/A
1424
1425 #### Windows (GPO)
1426 ```
1427 Software\Policies\Mozilla\Firefox\DisabledCiphers\CIPHER_NAME = 0x1 | 0x0
1428 ```
1429 #### Windows (Intune)
1430 OMA-URI:
1431 ```
1432 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~DisabledCiphers/DisabledCiphers_CIPHER_NAME
1433
1434 ```
1435 Value (string):
1436 ```
1437 <enabled/> or <disabled/>
1438 ```
1439 #### macOS
1440 ```
1441 <dict>
1442   <key>DisabledCiphers</key>
1443     <dict>
1444       <key>CIPHER_NAME</key>
1445       <true/> | <false/>
1446     </dict>
1447 </dict>
1448 ```
1449 #### policies.json
1450 ```
1451 {
1452   "policies": {
1453     "DisabledCiphers": {
1454       "CIPHER_NAME": true | false,
1455     }
1456   }
1457 }
1458 ```
1459 ### DisableDefaultBrowserAgent
1460 Prevent the default browser agent from taking any actions. Only applicable to Windows; other platforms don’t have the agent.
1461
1462 The browser agent is a Windows-only scheduled task which runs in the background to collect and submit data about the browser that the user has set as their OS default. More information is available [here](https://firefox-source-docs.mozilla.org/toolkit/mozapps/defaultagent/default-browser-agent/index.html).
1463
1464 **Compatibility:** Firefox 75, Firefox ESR 68.7 (Windows only)\
1465 **CCK2 Equivalent:** N/A\
1466 **Preferences Affected:** N/A
1467
1468 #### Windows (GPO)
1469 ```
1470 Software\Policies\Mozilla\Firefox\DisableDefaultBrowserAgent = 0x1 | 0x0
1471 ```
1472 #### Windows (Intune)
1473 OMA-URI:
1474 ```
1475 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableDefaultBrowserAgent
1476 ```
1477 Value (string):
1478 ```
1479 <enabled/> or <disabled/>
1480 ```
1481 #### policies.json
1482 ```
1483 {
1484   "policies": {
1485     "DisableDefaultBrowserAgent": true | false
1486   }
1487 }
1488 ```
1489 ### DisableDeveloperTools
1490 Remove access to all developer tools.
1491
1492 **Compatibility:** Firefox 60, Firefox ESR 60\
1493 **CCK2 Equivalent:** `removeDeveloperTools`\
1494 **Preferences Affected:** `devtools.policy.disabled`
1495
1496 #### Windows (GPO)
1497 ```
1498 Software\Policies\Mozilla\Firefox\DisableDeveloperTools = 0x1 | 0x0`
1499 ```
1500 #### Windows (Intune)
1501 OMA-URI:
1502 ```
1503 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableDeveloperTools
1504 ```
1505 Value (string):
1506 ```
1507 <enabled/> or <disabled/>
1508 ```
1509 #### macOS
1510 ```
1511 <dict>
1512   <key>DisableDeveloperTools</key>
1513   <true/> | <false/>
1514 </dict>
1515 ```
1516 #### policies.json
1517 ```
1518 {
1519   "policies": {
1520     "DisableDeveloperTools": true | false
1521   }
1522 }
1523 ```
1524 ### DisableFeedbackCommands
1525 Disable the menus for reporting sites (Submit Feedback, Report Deceptive Site).
1526
1527 **Compatibility:** Firefox 60, Firefox ESR 60\
1528 **CCK2 Equivalent:** N/A\
1529 **Preferences Affected:** N/A
1530
1531 #### Windows (GPO)
1532 ```
1533 Software\Policies\Mozilla\Firefox\DisableFeedbackCommands = 0x1 | 0x0
1534 ```
1535 #### Windows (Intune)
1536 OMA-URI:
1537 ```
1538 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableFeedbackCommands
1539 ```
1540 Value (string):
1541 ```
1542 <enabled/> or <disabled/>
1543 ```
1544 #### macOS
1545 ```
1546 <dict>
1547   <key>DisableFeedbackCommands</key>
1548   <true/> | <false/>
1549 </dict>
1550 ```
1551 #### policies.json
1552 ```
1553 {
1554   "policies": {
1555     "DisableFeedbackCommands": true | false
1556   }
1557 }
1558 ```
1559 ### DisableFirefoxAccounts
1560 Disable Firefox Accounts integration (Sync).
1561
1562 **Compatibility:** Firefox 60, Firefox ESR 60\
1563 **CCK2 Equivalent:** `disableSync`\
1564 **Preferences Affected:** `identity.fxaccounts.enabled`
1565
1566 #### Windows (GPO)
1567 ```
1568 Software\Policies\Mozilla\Firefox\DisableFirefoxAccounts = 0x1 | 0x0
1569 ```
1570 #### Windows (Intune)
1571 OMA-URI:
1572 ```
1573 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableFirefoxAccounts
1574 ```
1575 Value (string):
1576 ```
1577 <enabled/> or <disabled/>
1578 ```
1579 #### macOS
1580 ```
1581 <dict>
1582   <key>DisableFirefoxAccounts</key>
1583   <true/> | <false/>
1584 </dict>
1585 ```
1586 #### policies.json
1587 ```
1588 {
1589   "policies": {
1590     "DisableFirefoxAccounts": true | false
1591   }
1592 }
1593 ```
1594 ### DisableFirefoxScreenshots
1595 Remove access to Firefox Screenshots.
1596
1597 **Compatibility:** Firefox 60, Firefox ESR 60\
1598 **CCK2 Equivalent:** N/A\
1599 **Preferences Affected:** `extensions.screenshots.disabled`
1600
1601 #### Windows (GPO)
1602 ```
1603 Software\Policies\Mozilla\Firefox\DisableFirefoxScreenshots = 0x1 | 0x0
1604 ```
1605 #### Windows (Intune)
1606 OMA-URI:
1607 ```
1608 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableFirefoxScreenshots
1609 ```
1610 Value (string):
1611 ```
1612 <enabled/> or <disabled/>
1613 ```
1614 #### macOS
1615 ```
1616 <dict>
1617   <key>DisableFirefoxScreenshots</key>
1618   <true/> | <false/>
1619 </dict>
1620 ```
1621 #### policies.json
1622 ```
1623 {
1624   "policies": {
1625     "DisableFirefoxScreenshots": true | false
1626   }
1627 }
1628 ```
1629 ### DisableFirefoxStudies
1630 Disable Firefox studies (Shield).
1631
1632 **Compatibility:** Firefox 60, Firefox ESR 60\
1633 **CCK2 Equivalent:** N/A\
1634 **Preferences Affected:** N/A
1635
1636 #### Windows (GPO)
1637 ```
1638 Software\Policies\Mozilla\Firefox\DisableFirefoxStudies = 0x1 | 0x0
1639 ```
1640 #### Windows (Intune)
1641 OMA-URI:
1642 ```
1643 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableFirefoxStudies
1644 ```
1645 Value (string):
1646 ```
1647 <enabled/> or <disabled/>
1648 ```
1649 #### macOS
1650 ```
1651 <dict>
1652   <key>DisableFirefoxStudies</key>
1653   <true/> | <false/>
1654 </dict>
1655 ```
1656 #### policies.json
1657 ```
1658 {
1659   "policies": {
1660     "DisableFirefoxStudies": true | false
1661   }
1662 }
1663 ```
1664 ### DisableForgetButton
1665 Disable the "Forget" button.
1666
1667 **Compatibility:** Firefox 60, Firefox ESR 60\
1668 **CCK2 Equivalent:** `disableForget`\
1669 **Preferences Affected:** N/A
1670
1671 #### Windows (GPO)
1672 ```
1673 Software\Policies\Mozilla\Firefox\DisableForgetButton = 0x1 | 0x0
1674 ```
1675 #### Windows (Intune)
1676 OMA-URI:
1677 ```
1678 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableForgetButton
1679 ```
1680 Value (string):
1681 ```
1682 <enabled/> or <disabled/>
1683 ```
1684 #### macOS
1685 ```
1686 <dict>
1687   <key>DisableForgetButton</key>
1688   <true/> | <false/>
1689 </dict>
1690 ```
1691 #### policies.json
1692 ```
1693 {
1694   "policies": {
1695     "DisableForgetButton": true | false
1696   }
1697 }
1698 ```
1699 ### DisableFormHistory
1700 Turn off saving information on web forms and the search bar.
1701
1702 **Compatibility:** Firefox 60, Firefox ESR 60\
1703 **CCK2 Equivalent:** `disableFormFill`\
1704 **Preferences Affected:** `browser.formfill.enable`
1705
1706 #### Windows (GPO)
1707 ```
1708 Software\Policies\Mozilla\Firefox\DisableFormHistory = 0x1 | 0x0
1709 ```
1710 #### Windows (Intune)
1711 OMA-URI:
1712 ```
1713 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableFormHistory
1714 ```
1715 Value (string):
1716 ```
1717 <enabled/> or <disabled/>
1718 ```
1719 #### macOS
1720 ```
1721 <dict>
1722   <key>DisableFormHistory</key>
1723   <true/> | <false/>
1724 </dict>
1725 ```
1726 #### policies.json
1727 ```
1728 {
1729   "policies": {
1730     "DisableFormHistory": true | false
1731   }
1732 }
1733 ```
1734 ### DisableMasterPasswordCreation
1735 Remove the master password functionality.
1736
1737 If this value is true, it works the same as setting [`PrimaryPassword`](#primarypassword) to false and removes the primary password functionality.
1738
1739 If both `DisableMasterPasswordCreation` and `PrimaryPassword` are used, `DisableMasterPasswordCreation` takes precedent.
1740
1741 **Compatibility:** Firefox 60, Firefox ESR 60\
1742 **CCK2 Equivalent:** `noMasterPassword`\
1743 **Preferences Affected:** N/A
1744
1745 #### Windows (GPO)
1746 ```
1747 Software\Policies\Mozilla\Firefox\DisableMasterPasswordCreation = 0x1 | 0x0
1748 ```
1749 #### Windows (Intune)
1750 OMA-URI:
1751 ```
1752 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableMasterPasswordCreation
1753 ```
1754 Value (string):
1755 ```
1756 <enabled/> or <disabled/>
1757 ```
1758 #### macOS
1759 ```
1760 <dict>
1761   <key>DisableMasterPasswordCreation</key>
1762   <true/> | <false/>
1763 </dict>
1764 ```
1765 #### policies.json
1766 ```
1767 {
1768   "policies": {
1769     "DisableMasterPasswordCreation": true | false
1770   }
1771 }
1772 ```
1773 ### DisablePasswordReveal
1774 Do not allow passwords to be shown in saved logins
1775
1776 **Compatibility:** Firefox 71, Firefox ESR 68.3\
1777 **CCK2 Equivalent:** N/A
1778 **Preferences Affected:** N/A
1779
1780 #### Windows (GPO)
1781 ```
1782 Software\Policies\Mozilla\Firefox\DisablePasswordReveal = 0x1 | 0x0
1783 ```
1784 #### Windows (Intune)
1785 OMA-URI:
1786 ```
1787 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisablePasswordReveal
1788 ```
1789 Value (string):
1790 ```
1791 <enabled/> or <disabled/>
1792 ```
1793 #### macOS
1794 ```
1795 <dict>
1796   <key>DisablePasswordReveal</key>
1797   <true/> | <false/>
1798 </dict>
1799 ```
1800 #### policies.json
1801 ```
1802 {
1803   "policies": {
1804     "DisablePasswordReveal": true | false
1805   }
1806 }
1807 ```
1808 ### DisablePocket
1809 Remove Pocket in the Firefox UI. It does not remove it from the new tab page.
1810
1811 **Compatibility:** Firefox 60, Firefox ESR 60\
1812 **CCK2 Equivalent:** `disablePocket`\
1813 **Preferences Affected:** `extensions.pocket.enabled`
1814
1815 #### Windows (GPO)
1816 ```
1817 Software\Policies\Mozilla\Firefox\DisablePocket = 0x1 | 0x0
1818 ```
1819 #### Windows (Intune)
1820 OMA-URI:
1821 ```
1822 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisablePocket
1823 ```
1824 Value (string):
1825 ```
1826 <enabled/> or <disabled/>
1827 ```
1828 #### macOS
1829 ```
1830 <dict>
1831   <key>DisablePocket</key>
1832   <true/> | <false/>
1833 </dict>
1834 ```
1835 #### policies.json
1836 ```
1837 {
1838   "policies": {
1839     "DisablePocket": true | false
1840   }
1841 }
1842 ```
1843 ### DisablePrivateBrowsing
1844 Remove access to private browsing.
1845
1846 **Compatibility:** Firefox 60, Firefox ESR 60\
1847 **CCK2 Equivalent:** `disablePrivateBrowsing`\
1848 **Preferences Affected:** N/A
1849
1850 #### Windows (GPO)
1851 ```
1852 Software\Policies\Mozilla\Firefox\DisablePrivateBrowsing = 0x1 | 0x0
1853 ```
1854 #### Windows (Intune)
1855 OMA-URI:
1856 ```
1857 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisablePrivateBrowsing
1858 ```
1859 Value (string):
1860 ```
1861 <enabled/> or <disabled/>
1862 ```
1863 #### macOS
1864 ```
1865 <dict>
1866   <key>DisablePrivateBrowsing</key>
1867   <true/> | <false/>
1868 </dict>
1869 ```
1870 #### policies.json
1871 ```
1872 {
1873   "policies": {
1874     "DisablePrivateBrowsing": true | false
1875   }
1876 }
1877 ```
1878 ### DisableProfileImport
1879 Disables the "Import data from another browser" option in the bookmarks window.
1880
1881 **Compatibility:** Firefox 60, Firefox ESR 60\
1882 **CCK2 Equivalent:** N/A\
1883 **Preferences Affected:** N/A
1884
1885 #### Windows (GPO)
1886 ```
1887 Software\Policies\Mozilla\Firefox\DisableProfileImport = 0x1 | 0x0
1888 ```
1889 #### Windows (Intune)
1890 OMA-URI:
1891 ```
1892 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableProfileImport
1893 ```
1894 Value (string):
1895 ```
1896 <enabled/> or <disabled/>
1897 ```
1898 #### macOS
1899 ```
1900 <dict>
1901   <key>DisableProfileImport</key>
1902   <true/> | <false/>
1903 </dict>
1904 ```
1905 #### policies.json
1906 ```
1907 {
1908   "policies": {
1909     "DisableProfileImport": true | false
1910   }
1911 }
1912 ```
1913 ### DisableProfileRefresh
1914 Disable the Refresh Firefox button on about:support and support.mozilla.org, as well as the prompt that displays offering to refresh Firefox when you haven't used it in a while.
1915
1916 **Compatibility:** Firefox 60, Firefox ESR 60\
1917 **CCK2 Equivalent:** `disableResetFirefox`\
1918 **Preferences Affected:** `browser.disableResetPrompt`
1919
1920 #### Windows (GPO)
1921 ```
1922 Software\Policies\Mozilla\Firefox\DisableProfileRefresh = 0x1 | 0x0
1923 ```
1924 #### Windows (Intune)
1925 OMA-URI:
1926 ```
1927 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableProfileRefresh
1928 ```
1929 Value (string):
1930 ```
1931 <enabled/> or <disabled/>
1932 ```
1933 #### macOS
1934 ```
1935 <dict>
1936   <key>DisableProfileRefresh</key>
1937   <true/> | <false/>
1938 </dict>
1939 ```
1940 #### policies.json
1941 ```
1942 {
1943   "policies": {
1944     "DisableProfileRefresh": true | false
1945   }
1946 }
1947 ```
1948 ### DisableSafeMode
1949 Disable safe mode within the browser.
1950
1951 On Windows, this disables safe mode via the command line as well.
1952
1953 **Compatibility:** Firefox 60, Firefox ESR 60 (Windows, macOS)\
1954 **CCK2 Equivalent:** `disableSafeMode`\
1955 **Preferences Affected:** N/A
1956
1957 #### Windows (GPO)
1958 ```
1959 Software\Policies\Mozilla\Firefox\DisableSafeMode = 0x1 | 0x0
1960 ```
1961 #### Windows (Intune)
1962 OMA-URI:
1963 ```
1964 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableSafeMode
1965 ```
1966 Value (string):
1967 ```
1968 <enabled/> or <disabled/>
1969 ```
1970 #### macOS
1971 ```
1972 <dict>
1973   <key>DisableSafeMode</key>
1974   <true/> | <false/>
1975 </dict>
1976 ```
1977 #### policies.json
1978 ```
1979 {
1980   "policies": {
1981     "DisableSafeMode": true | false
1982   }
1983 }
1984 ```
1985 ### DisableSecurityBypass
1986 Prevent the user from bypassing security in certain cases.
1987
1988 `InvalidCertificate` prevents adding an exception when an invalid certificate is shown.
1989
1990 `SafeBrowsing` prevents selecting "ignore the risk" and visiting a harmful site anyway.
1991
1992 **Compatibility:** Firefox 60, Firefox ESR 60\
1993 **CCK2 Equivalent:** N/A\
1994 **Preferences Affected:** `security.certerror.hideAddException`, `browser.safebrowsing.allowOverride`
1995
1996 #### Windows (GPO)
1997 ```
1998 Software\Policies\Mozilla\Firefox\DisableSecurityBypass\InvalidCertificate = 0x1 | 0x0
1999 Software\Policies\Mozilla\Firefox\DisableSecurityBypass\SafeBrowsing = 0x1 | 0x0
2000 ```
2001 #### Windows (Intune)
2002 OMA-URI:
2003 ```
2004 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/P_DisableSecurityBypass_InvalidCertificate
2005 ```
2006 Value (string):
2007 ```
2008 <enabled/> or <disabled/>
2009 ```
2010 OMA-URI:
2011 ```
2012 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/P_DisableSecurityBypass_SafeBrowsing
2013 ```
2014 Value (string):
2015 ```
2016 <enabled/> or <disabled/>
2017 ```
2018
2019 #### macOS
2020 ```
2021 <dict>
2022   <key>DisableSecurityBypass</key>
2023   <dict>
2024     <key>InvalidCertificate</key>
2025     <true/> | <false/>
2026     <key>SafeBrowsing</key>
2027     <true/> | <false/>
2028   </dict>
2029 </dict>
2030 ```
2031 #### policies.json
2032 ```
2033 {
2034   "policies": {
2035     "DisableSecurityBypass": {
2036       "InvalidCertificate": true | false,
2037       "SafeBrowsing": true | false
2038     }
2039   }
2040 }
2041 ```
2042 ### DisableSetDesktopBackground
2043 Remove the "Set As Desktop Background..." menuitem when right clicking on an image.
2044
2045 **Compatibility:** Firefox 60, Firefox ESR 60\
2046 **CCK2 Equivalent:** `removeSetDesktopBackground`\
2047 **Preferences Affected:** N/A
2048
2049 #### Windows (GPO)
2050 ```
2051 Software\Policies\Mozilla\Firefox\DisableSetDesktopBackground = 0x1 | 0x0
2052 ```
2053 #### Windows (Intune)
2054 OMA-URI:
2055 ```
2056 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableSetDesktopBackground
2057 ```
2058 Value (string):
2059 ```
2060 <enabled/> or <disabled/>
2061 ```
2062 #### macOS
2063 ```
2064 <dict>
2065   <key>DisableSetDesktopBackground</key>
2066   <true/> | <false/>
2067 </dict>
2068 ```
2069 #### policies.json
2070 ```
2071 {
2072   "policies": {
2073     "DisableSetDesktopBackground": true | false
2074   }
2075 }
2076 ```
2077 ### DisableSystemAddonUpdate
2078 Prevent system add-ons from being installed or updated.
2079
2080 **Compatibility:** Firefox 60, Firefox ESR 60\
2081 **CCK2 Equivalent:** N/A\
2082 **Preferences Affected:** N/A
2083
2084 #### Windows (GPO)
2085 ```
2086 Software\Policies\Mozilla\Firefox\DisableSystemAddonUpdate = 0x1 | 0x0
2087 ```
2088 #### Windows (Intune)
2089 OMA-URI:
2090 ```
2091 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableSystemAddonUpdate
2092 ```
2093 Value (string):
2094 ```
2095 <enabled/> or <disabled/>
2096 ```
2097 #### macOS
2098 ```
2099 <dict>
2100   <key>DisableSystemAddonUpdate</key>
2101   <true/> | <false/>
2102 </dict>
2103 ```
2104 #### policies.json
2105 ```
2106 {
2107   "policies": {
2108     "DisableSystemAddonUpdate": true | false
2109   }
2110 }
2111 ```
2112 ### DisableTelemetry
2113 Prevent the upload of telemetry data.
2114
2115 As of Firefox 83 and Firefox ESR 78.5, local storage of telemetry data is disabled as well.
2116
2117 Mozilla recommends that you do not disable telemetry. Information collected through telemetry helps us build a better product for businesses like yours.
2118
2119 **Compatibility:** Firefox 60, Firefox ESR 60\
2120 **CCK2 Equivalent:** `disableTelemetry`\
2121 **Preferences Affected:** `datareporting.healthreport.uploadEnabled`, `datareporting.policy.dataSubmissionEnabled`, `toolkit.telemetry.archive.enabled`
2122
2123 #### Windows (GPO)
2124 ```
2125 Software\Policies\Mozilla\Firefox\DisableTelemetry = 0x1 | 0x0
2126 ```
2127 #### Windows (Intune)
2128 OMA-URI:
2129 ```
2130 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableTelemetry
2131 ```
2132 Value (string):
2133 ```
2134 <enabled/> or <disabled/>
2135 ```
2136 #### macOS
2137 ```
2138 <dict>
2139   <key>DisableTelemetry</key>
2140   <true/> | <false/>
2141 </dict>
2142 ```
2143 #### policies.json
2144 ```
2145 {
2146   "policies": {
2147     "DisableTelemetry": true | false
2148   }
2149 }
2150 ```
2151 ### DisableThirdPartyModuleBlocking
2152 Do not allow blocking third-party modules from the `about:third-party` page.
2153
2154 This policy only works on Windows through GPO (not policies.json).
2155
2156 **Compatibility:** Firefox 110 (Windows only, GPO only)\
2157 **CCK2 Equivalent:** N/A\
2158 **Preferences Affected:** N/A
2159
2160 #### Windows (GPO)
2161 ```
2162 Software\Policies\Mozilla\Firefox\DisableThirdPartyModuleBlocking = = 0x1 | 0x0
2163 ```
2164 #### Windows (Intune)
2165 OMA-URI:
2166 ```
2167 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableThirdPartyModuleBlocking
2168 ```
2169 Value (string):
2170 ```
2171 <enabled/> or <disabled/>
2172 ```
2173 ### DisplayBookmarksToolbar
2174 Set the initial state of the bookmarks toolbar. A user can still change how it is displayed.
2175
2176 `always` means the bookmarks toolbar is always shown.
2177
2178 `never` means the bookmarks toolbar is not shown.
2179
2180 `newtab` means the bookmarks toolbar is only shown on the new tab page.
2181
2182 **Compatibility:** Firefox 109, Firefox ESR 102.7\
2183 **CCK2 Equivalent:** N/A\
2184 **Preferences Affected:** N/A
2185
2186 #### Windows (GPO)
2187 ```
2188 Software\Policies\Mozilla\Firefox\DisplayBookmarksToolbar = "always", "never", "newtab"
2189 ```
2190 #### Windows (Intune)
2191 OMA-URI:
2192 ```
2193 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisplayBookmarksToolbar_Enum
2194 ```
2195 Value (string):
2196 ```
2197 <enabled/>
2198 <data id="DisplayBookmarksToolbar" value="always | never | newtab"/>
2199 ```
2200 #### macOS
2201 ```
2202 <dict>
2203   <key>DisplayBookmarksToolbar</key>
2204   <string>always | never | newtab</string>
2205 </dict>
2206 ```
2207 #### policies.json
2208 ```
2209 {
2210   "policies": {
2211     "DisplayBookmarksToolbar": "always" | "never" | "newtab"
2212   }
2213 }
2214 ```
2215 ### DisplayBookmarksToolbar (Deprecated)
2216 Set the initial state of the bookmarks toolbar. A user can still hide it and it will stay hidden.
2217
2218 **Compatibility:** Firefox 60, Firefox ESR 60\
2219 **CCK2 Equivalent:** `displayBookmarksToolbar`\
2220 **Preferences Affected:** N/A
2221
2222 #### Windows (GPO)
2223 ```
2224 Software\Policies\Mozilla\Firefox\DisplayBookmarksToolbar = 0x1 | 0x0
2225 ```
2226 #### Windows (Intune)
2227 OMA-URI:
2228 ```
2229 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisplayBookmarksToolbar
2230 ```
2231 Value (string):
2232 ```
2233 <enabled/> or <disabled/>
2234 ```
2235 #### macOS
2236 ```
2237 <dict>
2238   <key>DisplayBookmarksToolbar</key>
2239   <true/> | <false/>
2240 </dict>
2241 ```
2242 #### policies.json
2243 ```
2244 {
2245   "policies": {
2246     "DisplayBookmarksToolbar": true | false
2247   }
2248 }
2249 ```
2250 ### DisplayMenuBar
2251 Set the state of the menubar.
2252
2253 `always` means the menubar is shown and cannot be hidden.
2254
2255 `never` means the menubar is hidden and cannot be shown.
2256
2257 `default-on` means the menubar is on by default but can be hidden.
2258
2259 `default-off` means the menubar is off by default but can be shown.
2260
2261 **Compatibility:** Firefox 73, Firefox ESR 68.5 (Windows, some Linux)\
2262 **CCK2 Equivalent:** `displayMenuBar`\
2263 **Preferences Affected:** N/A
2264
2265 #### Windows (GPO)
2266 ```
2267 Software\Policies\Mozilla\Firefox\DisplayMenuBar = "always", "never", "default-on", "default-off"
2268 ```
2269 #### Windows (Intune)
2270 OMA-URI:
2271 ```
2272 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisplayMenuBar_Enum
2273 ```
2274 Value (string):
2275 ```
2276 <enabled/>
2277 <data id="DisplayMenuBar" value="always | never | default-on | default-off"/>
2278 ```
2279 #### macOS
2280 ```
2281 <dict>
2282   <key>DisplayMenuBar</key>
2283   <string>always | never | default-on | default-off</string>
2284 </dict>
2285 ```
2286 #### policies.json
2287 ```
2288 {
2289   "policies": {
2290     "DisplayMenuBar": "always", "never", "default-on", "default-off"
2291   }
2292 }
2293 ```
2294 ### DisplayMenuBar (Deprecated)
2295 Set the initial state of the menubar. A user can still hide it and it will stay hidden.
2296
2297 **Compatibility:** Firefox 60, Firefox ESR 60 (Windows, some Linux)\
2298 **CCK2 Equivalent:** `displayMenuBar`\
2299 **Preferences Affected:** N/A
2300
2301 #### Windows (GPO)
2302 ```
2303 Software\Policies\Mozilla\Firefox\DisplayMenuBar = 0x1 | 0x0
2304 ```
2305 #### macOS
2306 ```
2307 <dict>
2308   <key>DisplayMenuBar</key>
2309   <true/> | <false/>
2310 </dict>
2311 ```
2312 #### policies.json
2313 ```
2314 {
2315   "policies": {
2316     "DisplayMenuBar": true | false
2317   }
2318 }
2319 ```
2320 ### DNSOverHTTPS
2321 Configure DNS over HTTPS.
2322
2323 `Enabled` determines whether DNS over HTTPS is enabled
2324
2325 `ProviderURL` is a URL to another provider.
2326
2327 `Locked` prevents the user from changing DNS over HTTPS preferences.
2328
2329 `ExcludedDomains` excludes domains from DNS over HTTPS.
2330
2331 **Compatibility:** Firefox 63, Firefox ESR 68 (ExcludedDomains added in 75/68.7)\
2332 **CCK2 Equivalent:** N/A\
2333 **Preferences Affected:** `network.trr.mode`, `network.trr.uri`
2334
2335 #### Windows (GPO)
2336 ```
2337 Software\Policies\Mozilla\Firefox\DNSOverHTTPS\Enabled = 0x1 | 0x0
2338 Software\Policies\Mozilla\Firefox\DNSOverHTTPS\ProviderURL = "URL_TO_ALTERNATE_PROVIDER"
2339 Software\Policies\Mozilla\Firefox\DNSOverHTTPS\Locked = 0x1 | 0x0
2340 Software\Policies\Mozilla\Firefox\DNSOverHTTPS\ExcludedDomains\1 = "example.com"
2341 ```
2342 #### Windows (Intune)
2343 OMA-URI:
2344 ```
2345 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~DNSOverHTTPS/DNSOverHTTPS_Enabled
2346 ```
2347 Value (string):
2348 ```
2349 <enabled/> or <disabled/>
2350 ```
2351 OMA-URI:
2352 ```
2353 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~DNSOverHTTPS/DNSOverHTTPS_ProviderURL
2354 ```
2355 Value (string):
2356 ```
2357 <enabled/>
2358 <data id="String" value="URL_TO_ALTERNATE_PROVIDER"/>
2359 ```
2360 OMA-URI:
2361 ```
2362 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~DNSOverHTTPS/DNSOverHTTPS_Locked
2363 ```
2364 Value (string):
2365 ```
2366 <enabled/> or <disabled/>
2367 ```
2368 OMA-URI:
2369 ```
2370 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~DNSOverHTTPS/DNSOverHTTPS_ExcludedDomains
2371 ```
2372 Value (string):
2373 ```
2374 <enabled/>
2375 <data id="List" value="1&#xF000;example.com"/>
2376 ```
2377 #### macOS
2378 ```
2379 <dict>
2380   <key>DNSOverHTTPS</key>
2381   <dict>
2382     <key>Enabled</key>
2383     <true/> | <false/>
2384     <key>ProviderURL</key>
2385     <string>URL_TO_ALTERNATE_PROVIDER</string>
2386     <key>Locked</key>
2387     <true/> | <false/>
2388     <key>ExcludedDomains</key>
2389     <array>
2390       <string>example.com</string>
2391     </array>
2392   </dict>
2393 </dict>
2394 ```
2395 #### policies.json
2396 ```
2397 {
2398   "policies": {
2399     "DNSOverHTTPS": {
2400       "Enabled":  true | false,
2401       "ProviderURL": "URL_TO_ALTERNATE_PROVIDER",
2402       "Locked": true | false,
2403       "ExcludedDomains": ["example.com"]
2404     }
2405   }
2406 }
2407 ```
2408 ### DontCheckDefaultBrowser
2409 Don't check if Firefox is the default browser at startup.
2410
2411 **Compatibility:** Firefox 60, Firefox ESR 60\
2412 **CCK2 Equivalent:** `dontCheckDefaultBrowser`\
2413 **Preferences Affected:** `browser.shell.checkDefaultBrowser`
2414
2415 #### Windows (GPO)
2416 ```
2417 Software\Policies\Mozilla\Firefox\DontCheckDefaultBrowser = 0x1 | 0x0
2418 ```
2419 #### Windows (Intune)
2420 OMA-URI:
2421 ```
2422 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DontCheckDefaultBrowser
2423 ```
2424 Value (string):
2425 ```
2426 <enabled/> or <disabled/>
2427 ```
2428 #### macOS
2429 ```
2430 <dict>
2431   <key>DontCheckDefaultBrowser</key>
2432   <true/> | <false/>
2433 </dict>
2434 ```
2435 #### policies.json
2436 ```
2437 {
2438   "policies": {
2439     "DontCheckDefaultBrowser": true | false
2440   }
2441 }
2442 ```
2443 ### DownloadDirectory
2444 Set and lock the download directory.
2445
2446 You can use ${home} for the native home directory.
2447
2448 **Compatibility:** Firefox 68, Firefox ESR 68\
2449 **CCK2 Equivalent:** N/A\
2450 **Preferences Affected:** `browser.download.dir`, `browser.download.folderList`, `browser.download.useDownloadDir`
2451
2452 #### Windows (GPO)
2453 ```
2454 Software\Policies\Mozilla\Firefox\DownloadDirectory = "${home}\Downloads"
2455 ```
2456 #### Windows (Intune)
2457 OMA-URI:
2458 ```
2459 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DownloadDirectory
2460 ```
2461 Value (string):
2462 ```
2463 <enabled/>
2464 <data id="Preferences_String" value="${home}\Downloads"/>
2465 ```
2466 #### macOS
2467 ```
2468 <dict>
2469   <key>DownloadDirectory</key>
2470   <string>${home}/Downloads</string>
2471 </dict>
2472 ```
2473 #### policies.json (macOS and Linux)
2474 ```
2475 {
2476   "policies": {
2477     "DownloadDirectory": "${home}/Downloads"
2478 }
2479 ```
2480 #### policies.json (Windows)
2481 ```
2482 {
2483   "policies": {
2484     "DownloadDirectory": "${home}\\Downloads"
2485 }
2486 ```
2487 ### EnableTrackingProtection
2488 Configure tracking protection.
2489
2490 If this policy is not configured, tracking protection is not enabled by default in the browser, but it is enabled by default in private browsing and the user can change it.
2491
2492 If `Value` is set to false, tracking protection is disabled and locked in both the regular browser and private browsing.
2493
2494 If `Value` is set to true, tracking protection is enabled by default in both the regular browser and private browsing and the `Locked` value determines whether or not a user can change it.
2495
2496 If `Cryptomining` is set to true, cryptomining scripts on websites are blocked.
2497
2498 If `Fingerprinting` is set to true, fingerprinting scripts on websites are blocked.
2499
2500 If `EmailTracking` is set to true, hidden email tracking pixels and scripts on websites are blocked. (Firefox 112)
2501
2502 `Exceptions` are origins for which tracking protection is not enabled.
2503
2504 **Compatibility:** Firefox 60, Firefox ESR 60 (Cryptomining and Fingerprinting added in 70/68.2, Exceptions added in 73/68.5)\
2505 **CCK2 Equivalent:** N/A\
2506 **Preferences Affected:** `privacy.trackingprotection.enabled`, `privacy.trackingprotection.pbmode.enabled`, `privacy.trackingprotection.cryptomining.enabled`, `privacy.trackingprotection.fingerprinting.enabled`
2507
2508 #### Windows (GPO)
2509 ```
2510 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Value = 0x1 | 0x0
2511 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Locked = 0x1 | 0x0
2512 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Cryptomining = 0x1 | 0x0
2513 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Fingerprinting = 0x1 | 0x0
2514 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Exceptions\1 = "https://example.com"
2515 ```
2516 #### Windows (Intune)
2517 OMA-URI:
2518 ```
2519 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~TrackingProtection/A_TrackingProtection_Value
2520 ```
2521 Value (string):
2522 ```
2523 <enabled/> or <disabled/>
2524 ```
2525 OMA-URI:
2526 ```
2527 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~TrackingProtection/B_TrackingProtection_Cryptomining
2528 ```
2529 Value (string):
2530 ```
2531 <enabled/> or <disabled/>
2532 ```
2533 OMA-URI:
2534 ```
2535 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~TrackingProtection/C_TrackingProtection_Fingerprinting
2536 ```
2537 Value (string):
2538 ```
2539 <enabled/> or <disabled/>
2540 ```
2541 OMA-URI:
2542 ```
2543 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~TrackingProtection/D_TrackingProtection_Exceptions
2544 ```
2545 Value (string):
2546 ```
2547 <enabled/>
2548 <data id="TrackingProtection_Exceptions" value="1&#xF000;https://example.com"/>
2549 ```
2550 OMA-URI:
2551 ```
2552 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~TrackingProtection/E_TrackingProtection_Locked
2553 ```
2554 Value (string):
2555 ```
2556 <enabled/> or <disabled/>
2557 ```
2558 #### macOS
2559 ```
2560 <dict>
2561   <key>EnableTrackingProtection</key>
2562   <dict>
2563     <key>Value</key>
2564     <true/> | <false/>
2565     <key>Locked</key>
2566     <true/> | <false/>
2567     <key>Cryptomining</key>
2568     <true/> | <false/>
2569     <key>Fingerprinting</key>
2570     <true/> | <false/>
2571     <key>Exceptions</key>
2572     <array>
2573       <string>https://example.com</string>
2574     </array>
2575   </dict>
2576 </dict>
2577 ```
2578 #### policies.json
2579 ```
2580 {
2581   "policies": {
2582     "EnableTrackingProtection": {
2583       "Value": true | false,
2584       "Locked": true | false,
2585       "Cryptomining": true | false,
2586       "Fingerprinting": true | false,
2587       "Exceptions": ["https://example.com"]
2588     }
2589   }
2590 }
2591 ```
2592 ### EncryptedMediaExtensions
2593 Enable or disable Encrypted Media Extensions and optionally lock it.
2594
2595 If `Enabled` is set to false, encrypted media extensions (like Widevine) are not downloaded by Firefox unless the user consents to installing them.
2596
2597 If `Locked` is set to true and `Enabled` is set to false, Firefox will not download encrypted media extensions (like Widevine) or ask the user to install them.
2598
2599 **Compatibility:** Firefox 77, Firefox ESR 68.9\
2600 **CCK2 Equivalent:** N/A\
2601 **Preferences Affected:** `media.eme.enabled`
2602
2603 #### Windows (GPO)
2604 ```
2605 Software\Policies\Mozilla\Firefox\EncryptedMediaExtensions\Enabled = 0x1 | 0x0
2606 Software\Policies\Mozilla\Firefox\EncryptedMediaExtensions\Locked = 0x1 | 0x0
2607 ```
2608 #### Windows (Intune)
2609 OMA-URI:
2610 ```
2611 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~EncryptedMediaExtensions/EncryptedMediaExtensions_Enabled
2612 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~EncryptedMediaExtensions/EncryptedMediaExtensions_Locked
2613 ```
2614 Value (string):
2615 ```
2616 <enabled/>or <disabled/>
2617 ```
2618 #### macOS
2619 ```
2620 <dict>
2621   <key>EncryptedMediaExtensions</key>
2622   <dict>
2623     <key>Enabled</key>
2624     <true/> | <false/>
2625     <key>Locked</key>
2626     <true/> | <false/>
2627   </dict>
2628 </dict>
2629 ```
2630 #### policies.json
2631 ```
2632 {
2633   "policies": {
2634     "EncryptedMediaExtensions": {
2635       "Enabled": true | false,
2636       "Locked": true | false
2637     }
2638   }
2639 }
2640 ```
2641 ### EnterprisePoliciesEnabled
2642 Enable policy support on macOS.
2643
2644 **Compatibility:** Firefox 63, Firefox ESR 60.3 (macOS only)\
2645 **CCK2 Equivalent:** N/A\
2646 **Preferences Affected:** N/A
2647
2648 #### macOS
2649 ```
2650 <dict>
2651   <key>EnterprisePoliciesEnabled</key>
2652   <true/>
2653 </dict>
2654 ```
2655 ### ExemptDomainFileTypePairsFromFileTypeDownloadWarnings
2656
2657 Disable warnings based on file extension for specific file types on domains.
2658
2659 This policy is based on the [Chrome policy](https://chromeenterprise.google/policies/#ExemptDomainFileTypePairsFromFileTypeDownloadWarnings) of the same name.
2660
2661 Important: The documentation for the policy for both Edge and Chrome is incorrect. The ```domains``` value must be a domain, not a URL pattern. Also, we do not support using ```*``` to mean all domains.
2662
2663 **Compatibility:** Firefox 102\
2664 **CCK2 Equivalent:** N/A\
2665 **Preferences Affected:** N/A
2666
2667 #### Windows (GPO)
2668 Software\Policies\Mozilla\Firefox\ExemptDomainFileTypePairsFromFileTypeDownloadWarnings (REG_MULTI_SZ) =
2669 ```
2670 [
2671   {
2672      "file_extension": "jnlp",
2673      "domains": ["example.com"]
2674   }
2675 ]
2676 ```
2677 #### Windows (Intune)
2678 OMA-URI:
2679 ```
2680 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/ExemptDomainFileTypePairsFromFileTypeDownloadWarnings
2681 ```
2682 Value (string):
2683 ```
2684 <enabled/>
2685 <data id="JSON" value='
2686 [
2687   {
2688      "file_extension": "jnlp",
2689      "domains": ["example.com"]
2690   }
2691 ]
2692 '/>
2693 ```
2694 #### macOS
2695 ```
2696 <dict>
2697   <key>ExemptDomainFileTypePairsFromFileTypeDownloadWarnings</key>
2698   <array>
2699     <dict>
2700       <key>file_extension</key>
2701       <string>jnlp</string>
2702       <key>domains</key>
2703       <array>
2704         <string>example.com</string>
2705       </array>
2706     </dict>
2707   </array>
2708 </dict>
2709 ```
2710 #### policies.json
2711 ```
2712 {
2713   "policies": {
2714     "ExemptDomainFileTypePairsFromFileTypeDownloadWarnings": [{
2715       "file_extension": "jnlp",
2716       "domains": ["example.com"]
2717     }]
2718   }
2719 }
2720 ```
2721 ### Extensions
2722 Control the installation, uninstallation and locking of extensions.
2723
2724 While this policy is not technically deprecated, it is recommended that you use the **[`ExtensionSettings`](#extensionsettings)** policy. It has the same functionality and adds more. It does not support native paths, though, so you'll have to use file:/// URLs.
2725
2726 `Install` is a list of URLs or native paths for extensions to be installed.
2727
2728 `Uninstall` is a list of extension IDs that should be uninstalled if found.
2729
2730 `Locked` is a list of extension IDs that the user cannot disable or uninstall.
2731
2732 **Compatibility:** Firefox 60, Firefox ESR 60\
2733 **CCK2 Equivalent:** `addons`\
2734 **Preferences Affected:** N/A
2735
2736 #### Windows (GPO)
2737 ```
2738 Software\Policies\Mozilla\Firefox\Extensions\Install\1 = "https://addons.mozilla.org/firefox/downloads/somefile.xpi"
2739 Software\Policies\Mozilla\Firefox\Extensions\Install\2 = "//path/to/xpi"
2740 Software\Policies\Mozilla\Firefox\Extensions\Uninstall\1 = "bad_addon_id@mozilla.org"
2741 Software\Policies\Mozilla\Firefox\Extensions\Locked\1 = "addon_id@mozilla.org"
2742 ```
2743 #### Windows (Intune)
2744 OMA-URI:
2745 ```
2746 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Extensions/Extensions_Install
2747 ```
2748 Value (string):
2749 ```
2750 <enabled/>
2751 <data id="Extensions" value="1&#xF000;https://addons.mozilla.org/firefox/downloads/somefile.xpi&#xF000;2&#xF000;//path/to/xpi"/>
2752 ```
2753 OMA-URI:
2754 ```
2755 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Extensions/Extensions_Uninstall
2756 ```
2757 Value (string):
2758 ```
2759 <enabled/>
2760 <data id="Extensions" value="1&#xF000;bad_addon_id@mozilla.org"/>
2761 ```
2762 OMA-URI:
2763 ```
2764 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Extensions/Extensions_Locked
2765 ```
2766 Value (string):
2767 ```
2768 <enabled/>
2769 <data id="Extensions" value="1&#xF000;addon_id@mozilla.org"/>
2770 ```
2771 #### macOS
2772 ```
2773 <dict>
2774   <key>Extensions</key>
2775   <dict>
2776     <key>Install</key>
2777     <array>
2778       <string>https://addons.mozilla.org/firefox/downloads/somefile.xpi</string>
2779       <string>//path/to/xpi</string>
2780     </array>
2781     <key>Uninstall</key>
2782     <array>
2783       <string>bad_addon_id@mozilla.org</string>
2784     </array>
2785     <key>Locked</key>
2786     <array>
2787       <string>addon_id@mozilla.org</string>
2788     </array>
2789   </dict>
2790 </dict>
2791 ```
2792 #### policies.json
2793 ```
2794 {
2795   "policies": {
2796     "Extensions": {
2797       "Install": ["https://addons.mozilla.org/firefox/downloads/somefile.xpi", "//path/to/xpi"],
2798       "Uninstall": ["bad_addon_id@mozilla.org"],
2799       "Locked":  ["addon_id@mozilla.org"]
2800     }
2801   }
2802 }
2803 ```
2804 ### ExtensionSettings
2805 Manage all aspects of extensions. This policy is based heavily on the [Chrome policy](https://dev.chromium.org/administrators/policy-list-3/extension-settings-full) of the same name.
2806
2807 This policy maps an extension ID to its configuration. With an extension ID, the configuration will be applied to the specified extension only. A default configuration can be set for the special ID "*", which will apply to all extensions that don't have a custom configuration set in this policy.
2808
2809 To obtain an extension ID, install the extension and go to about:support. You will see the ID in the Extensions section. I've also created an extension that makes it easy to find the ID of extensions on AMO. You can download it [here](https://github.com/mkaply/queryamoid/releases/tag/v0.1).
2810
2811 The configuration for each extension is another dictionary that can contain the fields documented below.
2812
2813 | Name | Description |
2814 | --- | --- |
2815 | `installation_mode` | Maps to a string indicating the installation mode for the extension. The valid strings are `allowed`,`blocked`,`force_installed`, and `normal_installed`.
2816 | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`allowed` | Allows the extension to be installed by the user. This is the default behavior. There is no need for an install_url; it will automatically be allowed based on the ID.
2817 | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`blocked`| Blocks installation of the extension and removes it from the device if already installed.
2818 | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`force_installed`| The extension is automatically installed and can't be removed by the user. This option is not valid for the default configuration and requires an install_url.
2819 | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`normal_installed`| The extension is automatically installed but can be disabled by the user. This option is not valid for the default configuration and requires an install_url.
2820 | `install_url`| Maps to a URL indicating where Firefox can download a force_installed or normal_installed extension.  If installing from the local file system, use a [```file:///``` URL](https://en.wikipedia.org/wiki/File_URI_scheme). If installing from the addons.mozilla.org, use the following URL (substituting SHORT_NAME from the URL on AMO), https://addons.mozilla.org/firefox/downloads/latest/SHORT_NAME/latest.xpi. Languages packs are available from https://releases.mozilla.org/pub/firefox/releases/VERSION/PLATFORM/xpi/LANGUAGE.xpi. If you need to update the extension, you can change the name of the extension and it will be automatically updated. Extensions installed from file URLs will additional be updated when their internal version changes.
2821 | `install_sources` | A list of sources from which installing extensions is allowed using URL match patterns. **This is unnecessary if you are only allowing the installation of certain extensions by ID.** Each item in this list is an extension-style match pattern. Users will be able to easily install items from any URL that matches an item in this list. Both the location of the *.xpi file and the page where the download is started from (i.e.  the referrer) must be allowed by these patterns. This setting can be used only for the default configuration.
2822 | `allowed_types` | This setting whitelists the allowed types of extension/apps that can be installed in Firefox. The value is a list of strings, each of which should be one of the following: "extension", "theme", "dictionary", "locale" This setting can be used only for the default configuration.
2823 | `blocked_install_message` | This maps to a string specifying the error message to display to users if they're blocked from installing an extension. This setting allows you to append text to the generic error message displayed when the extension is blocked. This could be be used to direct users to your help desk, explain why a particular extension is blocked, or something else. This setting can be used only for the default configuration.
2824 | `restricted_domains` | An array of domains on which content scripts can't be run. This setting can be used only for the default configuration.
2825 | `updates_disabled` | (Firefox 89, Firefox ESR 78.11) Boolean that indicates whether or not to disable automatic updates for an individual extension.
2826
2827 **Compatibility:** Firefox 69, Firefox ESR 68.1 (As of Firefox 85, Firefox ESR 78.7, installing a theme makes it the default.)\
2828 **CCK2 Equivalent:** N/A\
2829 **Preferences Affected:** N/A
2830
2831 #### Windows (GPO)
2832 Software\Policies\Mozilla\Firefox\ExtensionSettings (REG_MULTI_SZ) =
2833 ```
2834 {
2835   "*": {
2836     "blocked_install_message": "Custom error message.",
2837     "install_sources": ["https://yourwebsite.com/*"],
2838     "installation_mode": "blocked",
2839     "allowed_types": ["extension"]
2840   },
2841   "uBlock0@raymondhill.net": {
2842     "installation_mode": "force_installed",
2843     "install_url": "https://addons.mozilla.org/firefox/downloads/latest/ublock-origin/latest.xpi"
2844   },
2845   "https-everywhere@eff.org": {
2846     "installation_mode": "allowed"
2847   }
2848 }
2849 ```
2850 #### Windows (Intune)
2851 OMA-URI:
2852 ```
2853 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Extensions/ExtensionSettings
2854 ```
2855 Value (string):
2856 ```
2857 <enabled/>
2858 <data id="ExtensionSettings" value='
2859 {
2860   "*": {
2861     "blocked_install_message": "Custom error message.",
2862     "install_sources": ["https://yourwebsite.com/*"],
2863     "installation_mode": "blocked",
2864     "allowed_types": ["extension"]
2865   },
2866   "uBlock0@raymondhill.net": {
2867     "installation_mode": "force_installed",
2868     "install_url": "https://addons.mozilla.org/firefox/downloads/latest/ublock-origin/latest.xpi"
2869   },
2870     "https-everywhere@eff.org": {
2871     "installation_mode": "allowed"
2872   }
2873 }'/>
2874 ```
2875 #### macOS
2876 ```
2877 <dict>
2878   <key>ExtensionSettings</key>
2879   <dict>
2880     <key>*</key>
2881     <dict>
2882       <key>blocked_install_message</key>
2883       <string>Custom error message.</string>
2884       <key>install_sources</key>
2885       <array>
2886         <string>"https://yourwebsite.com/*"</string>
2887       </array>
2888       <key>installation_mode</key>
2889       <string>blocked</string>
2890       <key>allowed_types</key>
2891       <array>
2892         <string>extension</string>
2893       </array>
2894     </dict>
2895     <key>uBlock0@raymondhill.net</key>
2896     <dict>
2897       <key>installation_mode</key>
2898        <string>force_installed</string>
2899       <key>install_url</key>
2900       <string>https://addons.mozilla.org/firefox/downloads/latest/ublock-origin/latest.xpi</string>
2901     </dict>
2902     <key>https-everywhere@eff.org</key>
2903     <dict>
2904       <key>installation_mode</key>
2905        <string>allowed</string>
2906     </dict>
2907   </dict>
2908 </dict>
2909 ```
2910 #### policies.json
2911 ```
2912 {
2913   "policies": {
2914     "ExtensionSettings": {
2915       "*": {
2916         "blocked_install_message": "Custom error message.",
2917         "install_sources": ["https://yourwebsite.com/*"],
2918         "installation_mode": "blocked",
2919         "allowed_types": ["extension"]
2920       },
2921       "uBlock0@raymondhill.net": {
2922         "installation_mode": "force_installed",
2923         "install_url": "https://addons.mozilla.org/firefox/downloads/latest/ublock-origin/latest.xpi"
2924       },
2925       "https-everywhere@eff.org": {
2926         "installation_mode": "allowed"
2927       }
2928     }
2929   }
2930 }
2931 ```
2932 ### ExtensionUpdate
2933 Control extension updates.
2934
2935 **Compatibility:** Firefox 67, Firefox ESR 60.7\
2936 **CCK2 Equivalent:** N/A\
2937 **Preferences Affected:** `extensions.update.enabled`
2938
2939 #### Windows (GPO)
2940 ```
2941 Software\Policies\Mozilla\Firefox\ExtensionUpdate = 0x1 | 0x0
2942 ```
2943 #### Windows (Intune)
2944 OMA-URI:
2945 ```
2946 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Extensions/ExtensionUpdate
2947 ```
2948 Value (string):
2949 ```
2950 <enabled/> or <disabled/>
2951 ```
2952 #### macOS
2953 ```
2954 <dict>
2955   <key>ExtensionUpdate</key>
2956   <true/> | <false/>
2957 </dict>
2958 ```
2959 #### policies.json
2960 ```
2961 {
2962   "policies": {
2963     "ExtensionUpdate": true | false
2964   }
2965 }
2966 ```
2967 ### FirefoxHome
2968 Customize the Firefox Home page.
2969
2970 **Compatibility:** Firefox 68, Firefox ESR 68 (SponsoredTopSites and SponsoredPocket were added in Firefox 95, Firefox ESR 91.4)
2971 **CCK2 Equivalent:** N/A\
2972 **Preferences Affected:** `browser.newtabpage.activity-stream.showSearch`, `browser.newtabpage.activity-stream.feeds.topsites`, `browser.newtabpage.activity-stream.feeds.section.highlights`, `browser.newtabpage.activity-stream.feeds.section.topstories`, `browser.newtabpage.activity-stream.feeds.snippets`, `browser.newtabpage.activity-stream.showSponsoredTopSites`, `browser.newtabpage.activity-stream.showSponsored`
2973
2974 #### Windows (GPO)
2975 ```
2976 Software\Policies\Mozilla\Firefox\FirefoxHome\Search = 0x1 | 0x0
2977 Software\Policies\Mozilla\Firefox\FirefoxHome\TopSites = 0x1 | 0x0
2978 Software\Policies\Mozilla\Firefox\FirefoxHome\SponsoredTopSites = 0x1 | 0x0
2979 Software\Policies\Mozilla\Firefox\FirefoxHome\Highlights = 0x1 | 0x0
2980 Software\Policies\Mozilla\Firefox\FirefoxHome\Pocket = 0x1 | 0x0
2981 Software\Policies\Mozilla\Firefox\FirefoxHome\SponsoredPocket = 0x1 | 0x0
2982 Software\Policies\Mozilla\Firefox\FirefoxHome\Snippets = 0x1 | 0x0
2983 Software\Policies\Mozilla\Firefox\FirefoxHome\Locked = 0x1 | 0x0
2984 ```
2985 #### Windows (Intune)
2986 OMA-URI:
2987 ```
2988 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/CustomizeFirefoxHome
2989 ```
2990 Value (string):
2991 ```
2992 <enabled/>
2993 <data id="FirefoxHome_Search"  value="true | false"/>
2994 <data id="FirefoxHome_TopSites"  value="true | false"/>
2995 <data id="FirefoxHome_SponsoredTopSites"  value="true | false"/>
2996 <data id="FirefoxHome_Highlights"  value="true | false"/>
2997 <data id="FirefoxHome_Pocket"  value="true | false"/>
2998 <data id="FirefoxHome_SponsoredPocket"  value="true | false"/>
2999 <data id="FirefoxHome_Snippets"  value="true | false"/>
3000 <data id="FirefoxHome_Locked"  value="true | false"/>
3001 ```
3002 #### macOS
3003 ```
3004 <dict>
3005   <key>FirefoxHome</key>
3006   <dict>
3007     <key>Search</key>
3008     <true/> | <false/>
3009     <key>TopSites</key>
3010     <true/> | <false/>
3011     <key>SponsoredTopSites</key>
3012     <true/> | <false/>
3013     <key>Highlights</key>
3014     <true/> | <false/>
3015     <key>Pocket</key>
3016     <true/> | <false/>
3017     <key>SponsoredPocket</key>
3018     <true/> | <false/>
3019     <key>Snippets</key>
3020     <true/> | <false/>
3021     <key>Locked</key>
3022     <true/> | <false/>
3023   </dict>
3024 </dict>
3025 ```
3026 #### policies.json
3027 ```
3028 {
3029   "policies": {
3030     "FirefoxHome": {
3031       "Search": true | false,
3032       "TopSites": true | false,
3033       "SponsoredTopSites": true | false,
3034       "Highlights": true | false,
3035       "Pocket": true | false,
3036       "SponsoredPocket": true | false,
3037       "Snippets": true | false,
3038       "Locked": true | false
3039     }
3040   }
3041 }
3042 ```
3043 ### FlashPlugin (Deprecated)
3044 Configure the default Flash plugin policy as well as origins for which Flash is allowed.
3045
3046 `Allow` is a list of origins where Flash are allowed.
3047
3048 `Block` is a list of origins where Flash is not allowed.
3049
3050 `Default` determines whether or not Flash is allowed by default.
3051
3052 `Locked` prevents the user from changing Flash preferences.
3053
3054 **Compatibility:** Firefox 60, Firefox ESR 60\
3055 **CCK2 Equivalent:** `permissions.plugin`\
3056 **Preferences Affected:** `plugin.state.flash`
3057
3058 #### Windows (GPO)
3059 ```
3060 Software\Policies\Mozilla\Firefox\FlashPlugin\Allow\1 = "https://example.org"
3061 Software\Policies\Mozilla\Firefox\FlashPlugin\Block\1 = "https://example.edu"
3062 Software\Policies\Mozilla\Firefox\FlashPlugin\Default = 0x1 | 0x0
3063 Software\Policies\Mozilla\Firefox\FlashPlugin\Locked = 0x1 | 0x0
3064 ```
3065 #### Windows (Intune)
3066 OMA-URI:
3067 ```
3068 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Flash/FlashPlugin_Allow
3069 ```
3070 Value (string):
3071 ```
3072 <enabled/>
3073 <data id="Permissions" value="1&#xF000;https://example.org&#xF000;2&#xF000;https://example.edu"/>
3074 ```
3075 OMA-URI:
3076 ```
3077 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Flash/FlashPlugin_Locked
3078 ```
3079 Value (string):
3080 ```
3081 <enabled/> or <disabled/>
3082 ```
3083 OMA-URI:
3084 ```
3085 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Flash/FlashPlugin_Default
3086 ```
3087 Value (string):
3088 ```
3089 <enabled/> or <disabled/>
3090 ```
3091 #### macOS
3092 ```
3093 <dict>
3094   <key>FlashPlugin</key>
3095   <dict>
3096     <key>Allow</key>
3097     <array>
3098       <string>http://example.org</string>
3099     </array>
3100     <key>Block</key>
3101     <array>
3102       <string>http://example.edu</string>
3103     </array>
3104     <key>Default</key>
3105     <true/> | <false/>
3106     <key>Locked</key>
3107     <true/> | <false/>
3108   </dict>
3109 </dict>
3110 ```
3111 #### policies.json
3112 ```
3113 {
3114   "policies": {
3115     "FlashPlugin": {
3116       "Allow": ["http://example.org/"],
3117       "Block": ["http://example.edu/"],
3118       "Default": true | false,
3119       "Locked": true | false
3120     }
3121   }
3122 }
3123 ```
3124 ### GoToIntranetSiteForSingleWordEntryInAddressBar
3125 Whether to always go through the DNS server before sending a single word search string to a search engine.
3126
3127 If the site exists, it will navigate to the website. If the intranet responds with a 404, the page will show a 404. If the intranet does not respond, the browser will attempt a search.
3128
3129 The second result in the URL bar will be a search result to allow users to conduct a web search exactly as it was entered.
3130
3131 If instead you would like to enable the ability to have your domain appear as a valid URL and to disallow the browser from ever searching that term using the first result that matches it, add the pref `browser.fixup.domainwhitelist.YOUR_DOMAIN` (where `YOUR_DOMAIN` is the name of the domain you'd like to add), and set the pref to `true`. The URL bar will then suggest `YOUR_DOMAIN` when the user fully types `YOUR_DOMAIN`. If the user attempts to load that domain and it fails to load, it will show an "Unable to connect" error page.
3132
3133 You can also whitelist a domain suffix that is not part of the [Public Suffix List](https://publicsuffix.org/) by adding the pref `browser.fixup.domainsuffixwhitelist.YOUR_DOMAIN_SUFFIX` with a value of `true`.
3134
3135 Additionally, if you want users to see a "Did you mean to go to 'YOUR_DOMAIN'" prompt below the URL bar if they land on a search results page instead of an intranet domain that provides a response, set the pref `browser.urlbar.dnsResolveSingleWordsAfterSearch` to `1`. Enabling this will cause the browser to commit a DNS check after every single word search. If the browser receives a response from the intranet, a prompt will ask the user if they'd like to instead navigate to `YOUR_DOMAIN`. If the user presses the **yes** button, `browser.fixup.domainwhitelist.YOUR_DOMAIN` will be set to `true`.
3136
3137 **Compatibility:** Firefox 104, Firefox ESR 102.2\
3138 **CCK2 Equivalent:** `N/A`\
3139 **Preferences Affected:** `browser.fixup.dns_first_for_single_words`
3140
3141 #### Windows (GPO)
3142 ```
3143 Software\Policies\Mozilla\Firefox\GoToIntranetSiteForSingleWordEntryInAddressBar = 0x1 | 0x0
3144 ```
3145 #### Windows (Intune)
3146 OMA-URI:
3147 ```
3148 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/GoToIntranetSiteForSingleWordEntryInAddressBar
3149 ```
3150 Value (string):
3151 ```
3152 <enabled/> or <disabled/>
3153 ```
3154 #### macOS
3155 ```
3156 <dict>
3157   <key>GoToIntranetSiteForSingleWordEntryInAddressBar</key>
3158   <true/> | <false/>
3159 </dict>
3160 ```
3161 #### policies.json
3162 ```
3163 {
3164   "policies": {
3165     "GoToIntranetSiteForSingleWordEntryInAddressBar": true | false
3166   }
3167 }
3168 ```
3169 ### Handlers
3170 Configure default application handlers. This policy is based on the internal format of `handlers.json`.
3171
3172 You can configure handlers based on a mime type (`mimeTypes`), a file's extension (`extensions`), or a protocol (`schemes`).
3173
3174 Within each handler type, you specify the given mimeType/extension/scheme as a key and use the following subkeys to describe how it is handled.
3175
3176 | Name | Description |
3177 | --- | --- |
3178 | `action`| Can be either `saveToDisk`, `useHelperApp`, `useSystemDefault`.
3179 | `ask` | If `true`, the user is asked if what they want to do with the file. If `false`, the action is taken without user intervention.
3180 | `handlers` | An array of handlers with the first one being the default. If you don't want to have a default handler, use an empty object for the first handler. Choose between path or uriTemplate.
3181 | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`name` | The display name of the handler (might not be used).
3182 | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`path`| The native path to the executable to be used.
3183 | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`uriTemplate`| A url to a web based application handler. The URL must be https and contain a %s to be used for substitution.
3184
3185 **Compatibility:** Firefox 78, Firefox ESR 78\
3186 **CCK2 Equivalent:** N/A\
3187 **Preferences Affected:** N/A
3188
3189 #### Windows (GPO)
3190 Software\Policies\Mozilla\Firefox\Handlers (REG_MULTI_SZ) =
3191 ```
3192 {
3193   "mimeTypes": {
3194     "application/msword": {
3195       "action": "useSystemDefault",
3196       "ask": true | false
3197     }
3198   },
3199   "schemes": {
3200     "mailto": {
3201       "action": "useHelperApp",
3202       "ask": true | false,
3203       "handlers": [{
3204         "name": "Gmail",
3205         "uriTemplate": "https://mail.google.com/mail/?extsrc=mailto&url=%s"
3206       }]
3207     }
3208   },
3209   "extensions": {
3210     "pdf": {
3211       "action": "useHelperApp",
3212       "ask": true | false,
3213       "handlers": [{
3214         "name": "Adobe Acrobat",
3215         "path": "C:\\Program Files (x86)\\Adobe\\Acrobat Reader DC\\Reader\\AcroRd32.exe"
3216       }]
3217     }
3218   }
3219 }
3220 ```
3221 #### Windows (Intune)
3222 OMA-URI:
3223 ```
3224 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/Handlers
3225 ```
3226 Value (string):
3227 ```
3228 <enabled/>
3229 <data id="Handlers" value='
3230 {
3231   "mimeTypes": {
3232     "application/msword": {
3233       "action": "useSystemDefault",
3234       "ask": true | false
3235     }
3236   },
3237   "schemes": {
3238     "mailto": {
3239       "action": "useHelperApp",
3240       "ask": true | false,
3241       "handlers": [{
3242         "name": "Gmail",
3243         "uriTemplate": "https://mail.google.com/mail/?extsrc=mailto&amp;url=%s"
3244       }]
3245     }
3246   },
3247   "extensions": {
3248     "pdf": {
3249       "action": "useHelperApp",
3250       "ask": true | false,
3251       "handlers": [{
3252         "name": "Adobe Acrobat",
3253         "path": "C:\\Program Files (x86)\\Adobe\\Acrobat Reader DC\\Reader\\AcroRd32.exe"
3254       }]
3255     }
3256   }
3257 }
3258 '/>
3259 ```
3260 #### macOS
3261 ```
3262 <dict>
3263   <key>Handlers</key>
3264   <dict>
3265     <key>mimeTypes</key>
3266     <dict>
3267       <key>application/msword</key>
3268       <dict>
3269         <key>action</key>
3270         <string>useSystemDefault</string>
3271         <key>ask</key>
3272         <true/> | <false/>
3273       </dict>
3274     </dict>
3275     <key>schemes</key>
3276     <dict>
3277       <key>mailto</key>
3278       <dict>
3279         <key>action</key>
3280         <string>useHelperApp</string>
3281         <key>ask</key>
3282         <true/> | <false/>
3283         <key>handlers</key>
3284         <array>
3285           <dict>
3286             <key>name</key>
3287             <string>Gmail</string>
3288             <key>uriTemplate</key>
3289             <string>https://mail.google.com/mail/?extsrc=mailto&url=%s</string>
3290           </dict>
3291         </array>
3292       </dict>
3293     </dict>
3294     <key>extensions</key>
3295     <dict>
3296       <key>pdf</key>
3297       <dict>
3298         <key>action</key>
3299         <string>useHelperApp</string>
3300         <key>ask</key>
3301         <true/> | <false/>
3302         <key>handlers</key>
3303         <array>
3304           <dict>
3305             <key>name</key>
3306             <string>Adobe Acrobat</string>
3307             <key>path</key>
3308             <string>/System/Applications/Preview.app</string>
3309           </dict>
3310         </array>
3311       </dict>
3312     </dict>
3313   </dict>
3314 </dict>
3315 ```
3316 #### policies.json
3317 ```
3318 {
3319   "policies": {
3320     "Handlers": {
3321       "mimeTypes": {
3322         "application/msword": {
3323           "action": "useSystemDefault",
3324           "ask": false
3325         }
3326       },
3327       "schemes": {
3328         "mailto": {
3329           "action": "useHelperApp",
3330           "ask": true | false,
3331           "handlers": [{
3332             "name": "Gmail",
3333             "uriTemplate": "https://mail.google.com/mail/?extsrc=mailto&url=%s"
3334           }]
3335         }
3336       },
3337       "extensions": {
3338         "pdf": {
3339           "action": "useHelperApp",
3340           "ask": true | false,
3341           "handlers": [{
3342             "name": "Adobe Acrobat",
3343             "path": "/usr/bin/acroread"
3344           }]
3345         }
3346       }
3347     }
3348   }
3349 }
3350 ```
3351 ### HardwareAcceleration
3352 Control hardware acceleration.
3353
3354 **Compatibility:** Firefox 60, Firefox ESR 60\
3355 **CCK2 Equivalent:** N/A\
3356 **Preferences Affected:** `layers.acceleration.disabled`
3357
3358 #### Windows (GPO)
3359 ```
3360 Software\Policies\Mozilla\Firefox\HardwareAcceleration = 0x1 | 0x0
3361 ```
3362 #### Windows (Intune)
3363 OMA-URI:
3364 ```
3365 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/HardwareAcceleration
3366 ```
3367 Value (string):
3368 ```
3369 <enabled/> or <disabled/>
3370 ```
3371 #### macOS
3372 ```
3373 <dict>
3374   <key>HardwareAcceleration</key>
3375   <true/> | <false/>
3376 </dict>
3377 ```
3378 #### policies.json
3379 ```
3380 {
3381   "policies": {
3382     "HardwareAcceleration": true | false
3383   }
3384 }
3385 ```
3386 ### Homepage
3387 Configure the default homepage and how Firefox starts.
3388
3389 `URL` is the default homepage.
3390
3391 `Locked` prevents the user from changing homepage preferences.
3392
3393 `Additional` allows for more than one homepage.
3394
3395 `StartPage` is how Firefox starts. The choices are no homepage, the default homepage or the previous session.
3396
3397 With Firefox 78, an additional option as added for `Startpage`, `homepage-locked`. If this is value is set for the Startpage, the user will always get the homepage at startup and cannot choose to restore their session.
3398
3399 **Compatibility:** Firefox 60, Firefox ESR 60 (StartPage was added in Firefox 60, Firefox ESR 60.4, homepage-locked added in Firefox 78)\
3400 **CCK2 Equivalent:** `homePage`,`lockHomePage`\
3401 **Preferences Affected:** `browser.startup.homepage`, `browser.startup.page`
3402
3403 #### Windows (GPO)
3404 ```
3405 Software\Policies\Mozilla\Firefox\Homepage\URL = "https://example.com"
3406 Software\Policies\Mozilla\Firefox\Homepage\Locked = 0x1 | 0x0
3407 Software\Policies\Mozilla\Firefox\Homepage\Additional\1 = "https://example.org"
3408 Software\Policies\Mozilla\Firefox\Homepage\Additional\2 = "https://example.edu"
3409 Software\Policies\Mozilla\Firefox\Homepage\StartPage = "none" | "homepage" | "previous-session" | "homepage-locked"
3410 ```
3411 #### Windows (Intune)
3412 OMA-URI:
3413 ```
3414 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Homepage/HomepageURL
3415 ```
3416 Value (string):
3417 ```
3418 <enabled/>
3419
3420 <data id="HomepageURL" value="https://example.com"/>
3421 <data id="HomepageLocked" value="true | false"/>
3422 ```
3423 OMA-URI:
3424 ```
3425 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Homepage/HomepageAdditional
3426 ```
3427 Value (string):
3428 ```
3429 <enabled/>
3430
3431 <data id="HomepageAdditional" value="1&#xF000;http://example.org&#xF000;2&#xF000;http://example.edu"/>
3432 ```
3433 OMA-URI:
3434 ```
3435 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Homepage/HomepageStartPage
3436 ```
3437 Value (string):
3438 ```
3439 <enabled/>
3440
3441 <data id="StartPage" value="none | homepage | previous-session"/>
3442 ```
3443 #### macOS
3444 ```
3445 <dict>
3446   <key>Homepage</key>
3447   <dict>
3448     <key>URL</key>
3449     <string>http://example.com</string>
3450     <key>Locked</key>
3451     <true/> | <false/>
3452     <key>Additional</key>
3453     <array>
3454       <string>http://example.org</string>
3455       <string>http://example.edu</string>
3456     </array>
3457     <key>StartPage</key>
3458     <string>none | homepage | previous-session | homepage-locked</string>
3459   </dict>
3460 </dict>
3461 ```
3462 #### policies.json
3463 ```
3464 {
3465   "policies": {
3466     "Homepage": {
3467       "URL": "http://example.com/",
3468       "Locked": true | false,
3469       "Additional": ["http://example.org/",
3470                      "http://example.edu/"],
3471       "StartPage": "none" | "homepage" | "previous-session" | "homepage-locked"
3472     }
3473   }
3474 }
3475 ```
3476 ### InstallAddonsPermission
3477 Configure the default extension install policy as well as origins for extension installs are allowed. This policy does not override turning off all extension installs.
3478
3479 `Allow` is a list of origins where extension installs are allowed.
3480
3481 `Default` determines whether or not extension installs are allowed by default.
3482
3483 **Compatibility:** Firefox 60, Firefox ESR 60\
3484 **CCK2 Equivalent:** `permissions.install`\
3485 **Preferences Affected:** `xpinstall.enabled`
3486
3487 #### Windows (GPO)
3488 ```
3489 Software\Policies\Mozilla\Firefox\InstallAddonsPermission\Allow\1 = "https://example.org"
3490 Software\Policies\Mozilla\Firefox\InstallAddonsPermission\Allow\2 = "https://example.edu"
3491 Software\Policies\Mozilla\Firefox\InstallAddonsPermission\Default = 0x1 | 0x0
3492 ```
3493 #### Windows (Intune)
3494 OMA-URI:
3495 ```
3496 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Addons/InstallAddonsPermission_Allow
3497 ```
3498 Value (string):
3499 ```
3500 <enabled/>
3501 <data id="Permissions" value="1&#xF000;https://example.org&#xF000;2&#xF000;https://example.edu"/>
3502 ```
3503 OMA-URI:
3504 ```
3505 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Addons/InstallAddonsPermission_Default
3506 ```
3507 Value (string):
3508 ```
3509 <enabled/>
3510 ```
3511 #### macOS
3512 ```
3513 <dict>
3514   <key>InstallAddonsPermission</key>
3515   <dict>
3516     <key>Allow</key>
3517     <array>
3518       <string>http://example.org</string>
3519       <string>http://example.edu</string>
3520     </array>
3521     <key>Default</key>
3522     <true/> | <false/>
3523   </dict>
3524 </dict>
3525 ```
3526 #### policies.json
3527 ```
3528 {
3529   "policies": {
3530     "InstallAddonsPermission": {
3531       "Allow": ["http://example.org/",
3532                 "http://example.edu/"],
3533       "Default": true | false
3534     }
3535   }
3536 }
3537 ```
3538 ### LegacyProfiles
3539 Disable the feature enforcing a separate profile for each installation.
3540
3541 If this policy set to true, Firefox will not try to create different profiles for installations of Firefox in different directories. This is the equivalent of the MOZ_LEGACY_PROFILES environment variable.
3542
3543 If this policy set to false, Firefox will create a new profile for each unique installation of Firefox.
3544
3545 This policy only work on Windows via GPO (not policies.json).
3546
3547 **Compatibility:** Firefox 70, Firefox ESR 68.2 (Windows only, GPO only)\
3548 **CCK2 Equivalent:** N/A\
3549 **Preferences Affected:** N/A
3550
3551 #### Windows (GPO)
3552 ```
3553 Software\Policies\Mozilla\Firefox\LegacyProfiles = = 0x1 | 0x0
3554 ```
3555 #### Windows (Intune)
3556 OMA-URI:
3557 ```
3558 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/LegacyProfiles
3559 ```
3560 Value (string):
3561 ```
3562 <enabled/> or <disabled/>
3563 ```
3564 ### LegacySameSiteCookieBehaviorEnabled
3565 Enable default legacy SameSite cookie behavior setting.
3566
3567 If this policy is set to true, it reverts all cookies to legacy SameSite behavior which means that cookies that don't explicitly specify a ```SameSite``` attribute are treated as if they were ```SameSite=None```.
3568
3569 **Compatibility:** Firefox 96\
3570 **CCK2 Equivalent:** N/A\
3571 **Preferences Affected:** `network.cookie.sameSite.laxByDefault`
3572
3573 #### Windows (GPO)
3574 ```
3575 Software\Policies\Mozilla\Firefox\LegacySameSiteCookieBehaviorEnabled = = 0x1 | 0x0
3576 ```
3577 #### Windows (Intune)
3578 OMA-URI:
3579 ```
3580 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/LegacySameSiteCookieBehaviorEnabled
3581 ```
3582 Value (string):
3583 ```
3584 <enabled/> or <disabled/>
3585 ```
3586 #### macOS
3587 ```
3588 <dict>
3589   <key>LegacySameSiteCookieBehaviorEnabled</key>
3590   <true/> | <false/>
3591 </dict>
3592 ```
3593 #### policies.json
3594 ```
3595 {
3596   "policies": {
3597     "LegacySameSiteCookieBehaviorEnabled": true | false
3598 }
3599 ```
3600 ### LegacySameSiteCookieBehaviorEnabledForDomainList
3601 Revert to legacy SameSite behavior for cookies on specified sites.
3602
3603 If this policy is set to true, cookies set for domains in this list will revert to legacy SameSite behavior which means that cookies that don't explicitly specify a ```SameSite``` attribute are treated as if they were ```SameSite=None```.
3604
3605 **Compatibility:** Firefox 96\
3606 **CCK2 Equivalent:** N/A\
3607 **Preferences Affected:** `network.cookie.sameSite.laxByDefault.disabledHosts`
3608
3609 #### Windows (GPO)
3610 ```
3611 Software\Policies\Mozilla\Firefox\LegacySameSiteCookieBehaviorEnabledForDomainList\1 = "example.org"
3612 Software\Policies\Mozilla\Firefox\LegacySameSiteCookieBehaviorEnabledForDomainList\2 = "example.edu"
3613 ```
3614 #### Windows (Intune)
3615 OMA-URI:
3616 ```
3617 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/LegacySameSiteCookieBehaviorEnabledForDomainList
3618 ```
3619 Value (string):
3620 ```
3621 <enabled/>
3622 <data id="LegacySameSiteCookieBehaviorEnabledForDomainList" value="1&#xF000;example.org&#xF000;2&#xF000;example.edu"/>
3623 ```
3624 #### macOS
3625 ```
3626 <dict>
3627   <key>LegacySameSiteCookieBehaviorEnabledForDomainList</key>
3628   <array>
3629     <string>example.org</string>
3630     <string>example.edu</string>
3631   </array>
3632 </dict>
3633 ```
3634 #### policies.json
3635 ```
3636 {
3637   "policies": {
3638     "LegacySameSiteCookieBehaviorEnabledForDomainList": ["example.org",
3639                                                          "example.edu"]
3640   }
3641 }
3642 ```
3643 ### LocalFileLinks
3644 Enable linking to local files by origin.
3645
3646 **Compatibility:** Firefox 68, Firefox ESR 68\
3647 **CCK2 Equivalent:** N/A\
3648 **Preferences Affected:** `capability.policy.localfilelinks.*`
3649
3650 #### Windows (GPO)
3651 ```
3652 Software\Policies\Mozilla\Firefox\LocalFileLinks\1 = "https://example.org"
3653 Software\Policies\Mozilla\Firefox\LocalFileLinks\2 = "https://example.edu"
3654 ```
3655 #### Windows (Intune)
3656 OMA-URI:
3657 ```
3658 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/LocalFileLinks
3659 ```
3660 Value (string):
3661 ```
3662 <enabled/>
3663 <data id="LocalFileLinks" value="1&#xF000;https://example.org&#xF000;2&#xF000;https://example.edu"/>
3664 ```
3665 #### macOS
3666 ```
3667 <dict>
3668   <key>LocalFileLinks</key>
3669   <array>
3670     <string>http://example.org</string>
3671     <string>http://example.edu</string>
3672   </array>
3673 </dict>
3674 ```
3675 #### policies.json
3676 ```
3677 {
3678   "policies": {
3679     "LocalFileLinks": ["http://example.org/",
3680                        "http://example.edu/"]
3681   }
3682 }
3683 ```
3684 ### ManagedBookmarks
3685 Configures a list of bookmarks managed by an administrator that cannot be changed by the user.
3686
3687 The bookmarks are only added as a button on the personal toolbar. They are not in the bookmarks folder.
3688
3689 The syntax of this policy is exactly the same as the [Chrome ManagedBookmarks policy](https://cloud.google.com/docs/chrome-enterprise/policies/?policy=ManagedBookmarks). The schema is:
3690 ```
3691 {
3692  "items": {
3693   "id": "BookmarkType",
3694   "properties": {
3695    "children": {
3696     "items": {
3697      "$ref": "BookmarkType"
3698     },
3699     "type": "array"
3700    },
3701    "name": {
3702     "type": "string"
3703    },
3704    "toplevel_name": {
3705     "type": "string"
3706    },
3707    "url": {
3708     "type": "string"
3709    }
3710   },
3711   "type": "object"
3712  },
3713  "type": "array"
3714 }
3715 ```
3716 **Compatibility:** Firefox 83, Firefox ESR 78.5\
3717 **CCK2 Equivalent:** N/A\
3718 **Preferences Affected:** N/A
3719
3720 #### Windows (GPO)
3721 Software\Policies\Mozilla\Firefox\ManagedBookmarks (REG_MULTI_SZ) =
3722 ```
3723 [
3724   {
3725     "toplevel_name": "My managed bookmarks folder"
3726   },
3727   {
3728     "url": "example.com",
3729     "name": "Example"
3730   },
3731   {
3732     "name": "Mozilla links",
3733     "children": [
3734       {
3735         "url": "https://mozilla.org",
3736         "name": "Mozilla.org"
3737       },
3738       {
3739         "url": "https://support.mozilla.org/",
3740         "name": "SUMO"
3741       }
3742     ]
3743   }
3744 ]
3745 ```
3746 #### Windows (Intune)
3747 OMA-URI:
3748 ```
3749 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/ManagedBookmarks
3750 ```
3751 Value (string):
3752 ```
3753 <enabled/>
3754 <data id="JSON" value='
3755 [
3756   {
3757     "toplevel_name": "My managed bookmarks folder"
3758   },
3759   {
3760     "url": "example.com",
3761     "name": "Example"
3762   },
3763   {
3764     "name": "Mozilla links",
3765     "children": [
3766       {
3767         "url": "https://mozilla.org",
3768         "name": "Mozilla.org"
3769       },
3770       {
3771         "url": "https://support.mozilla.org/",
3772         "name": "SUMO"
3773       }
3774     ]
3775   }
3776 ]'/>
3777 ```
3778 #### macOS
3779 ```
3780 <dict>
3781   <key>ManagedBookmarks</key>
3782   <array>
3783     <dict>
3784       <key>toplevel_name</key>
3785       <string>My managed bookmarks folder</string>
3786       <dict>
3787         <key>url</key>
3788         <string>example.com</string>
3789         <key>name</key>
3790         <string>Example</string>
3791       </dict>
3792       <dict>
3793       <key>name</key>
3794       <string>Mozilla links</string>
3795       <key>children</key>
3796       <array>
3797         <dict>
3798           <key>url</key>
3799           <string>https://mozilla.org</string>
3800           <key>name</key>
3801           <string>Mozilla</string>
3802         </dict>
3803         <dict>
3804           <key>url</key>
3805           <string>https://support.mozilla.org/</string>
3806           <key>name</key>
3807           <string>SUMO</string>
3808         </dict>
3809       </array>
3810     </dict>
3811   </array>
3812 </dict>
3813 ```
3814 #### policies.json
3815 ```
3816 {
3817   "policies": {
3818     "ManagedBookmarks": [
3819       {
3820         "toplevel_name": "My managed bookmarks folder"
3821       },
3822       {
3823         "url": "example.com",
3824         "name": "Example"
3825       },
3826       {
3827         "name": "Mozilla links",
3828         "children": [
3829           {
3830             "url": "https://mozilla.org",
3831             "name": "Mozilla.org"
3832           },
3833           {
3834             "url": "https://support.mozilla.org/",
3835             "name": "SUMO"
3836           }
3837         ]
3838       }
3839     ]
3840   }
3841 }
3842 ```
3843 ### ManualAppUpdateOnly
3844
3845 Switch to manual updates only.
3846
3847 If this policy is enabled:
3848  1. The user will never be prompted to install updates
3849  2. Firefox will not check for updates in the background, though it will check automatically when an update UI is displayed (such as the one in the About dialog). This check will be used to show "Update to version X" in the UI, but will not automatically download the update or prompt the user to update in any other way.
3850  3. The update UI will work as expected, unlike when using DisableAppUpdate.
3851
3852 This policy is primarily intended for advanced end users, not for enterprises.
3853
3854 **Compatibility:** Firefox 87\
3855 **CCK2 Equivalent:** N/A\
3856 **Preferences Affected:** N/A
3857
3858 #### policies.json
3859 ```
3860 {
3861   "policies": {
3862     "ManualAppUpdateOnly": true | false
3863   }
3864 }
3865 ```
3866 ### NetworkPrediction
3867 Enable or disable network prediction (DNS prefetching).
3868
3869 **Compatibility:** Firefox 67, Firefox ESR 60.7\
3870 **CCK2 Equivalent:** N/A\
3871 **Preferences Affected:** `network.dns.disablePrefetch`, `network.dns.disablePrefetchFromHTTPS`
3872
3873 #### Windows (GPO)
3874 ```
3875 Software\Policies\Mozilla\Firefox\NetworkPrediction = 0x1 | 0x0
3876 ```
3877 #### Windows (Intune)
3878 OMA-URI:
3879 ```
3880 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/NetworkPrediction
3881 ```
3882 Value (string):
3883 ```
3884 <enabled/> or <disabled/>
3885 ```
3886 #### macOS
3887 ```
3888 <dict>
3889   <key>NetworkPrediction</key>
3890   <true/> | <false/>
3891 </dict>
3892 ```
3893 #### policies.json
3894 ```
3895 {
3896   "policies": {
3897     "NetworkPrediction": true | false
3898 }
3899 ```
3900 ### NewTabPage
3901 Enable or disable the New Tab page.
3902
3903 **Compatibility:** Firefox 68, Firefox ESR 68\
3904 **CCK2 Equivalent:** N/A\
3905 **Preferences Affected:** `browser.newtabpage.enabled`
3906
3907 #### Windows (GPO)
3908 ```
3909 Software\Policies\Mozilla\Firefox\NewTabPage = 0x1 | 0x0
3910 ```
3911 #### Windows (Intune)
3912 OMA-URI:
3913 ```
3914 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/NewTabPage
3915 ```
3916 Value (string):
3917 ```
3918 <enabled/> or <disabled/>
3919 ```
3920 #### macOS
3921 ```
3922 <dict>
3923   <key>NewTabPage</key>
3924   <true/> | <false/>
3925 </dict>
3926 ```
3927 #### policies.json
3928 ```
3929 {
3930   "policies": {
3931     "NewTabPage": true | false
3932 }
3933 ```
3934 ### NoDefaultBookmarks
3935 Disable the creation of default bookmarks.
3936
3937 This policy is only effective if the user profile has not been created yet.
3938
3939 **Compatibility:** Firefox 60, Firefox ESR 60\
3940 **CCK2 Equivalent:** `removeDefaultBookmarks`\
3941 **Preferences Affected:** N/A
3942
3943 #### Windows (GPO)
3944 ```
3945 Software\Policies\Mozilla\Firefox\NoDefaultBookmarks = 0x1 | 0x0
3946 ```
3947 #### Windows (Intune)
3948 OMA-URI:
3949 ```
3950 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/NoDefaultBookmarks
3951 ```
3952 Value (string):
3953 ```
3954 <enabled/> or <disabled/>
3955 ```
3956 #### macOS
3957 ```
3958 <dict>
3959   <key>NoDefaultBookmarks</key>
3960   <true/> | <false/>
3961 </dict>
3962 ```
3963 #### policies.json
3964 ```
3965 {
3966   "policies": {
3967     "NoDefaultBookmarks": true | false
3968   }
3969 }
3970 ```
3971 ### OfferToSaveLogins
3972 Control whether or not Firefox offers to save passwords.
3973
3974 **Compatibility:** Firefox 60, Firefox ESR 60\
3975 **CCK2 Equivalent:** `dontRememberPasswords`\
3976 **Preferences Affected:** `signon.rememberSignons`
3977
3978 #### Windows (GPO)
3979 ```
3980 Software\Policies\Mozilla\Firefox\OfferToSaveLogins = 0x1 | 0x0
3981 ```
3982 #### Windows (Intune)
3983 OMA-URI:
3984 ```
3985 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/OfferToSaveLogins
3986 ```
3987 Value (string):
3988 ```
3989 <enabled/> or <disabled/>
3990 ```
3991 #### macOS
3992 ```
3993 <dict>
3994   <key>OfferToSaveLogins</key>
3995   <true/> | <false/>
3996 </dict>
3997 ```
3998 #### policies.json
3999 ```
4000 {
4001   "policies": {
4002     "OfferToSaveLogins": true | false
4003   }
4004 }
4005 ```
4006 ### OfferToSaveLoginsDefault
4007 Sets the default value of signon.rememberSignons without locking it.
4008
4009 **Compatibility:** Firefox 70, Firefox ESR 60.2\
4010 **CCK2 Equivalent:** `dontRememberPasswords`\
4011 **Preferences Affected:** `signon.rememberSignons`
4012
4013 #### Windows (GPO)
4014 ```
4015 Software\Policies\Mozilla\Firefox\OfferToSaveLoginsDefault = 0x1 | 0x0
4016 ```
4017 #### Windows (Intune)
4018 OMA-URI:
4019 ```
4020 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/OfferToSaveLoginsDefault
4021 ```
4022 Value (string):
4023 ```
4024 <enabled/> or <disabled/>
4025 ```
4026 #### macOS
4027 ```
4028 <dict>
4029   <key>OfferToSaveLoginsDefault</key>
4030   <true/> | <false/>
4031 </dict>
4032 ```
4033 #### policies.json
4034 ```
4035 {
4036   "policies": {
4037     "OfferToSaveLoginsDefault": true | false
4038   }
4039 }
4040 ```
4041 ### OverrideFirstRunPage
4042 Override the first run page. If the value is an empty string (""), the first run page is not displayed.
4043
4044 Starting with Firefox 83, Firefox ESR 78.5, you can also specify multiple URLS separated by a vertical bar (|).
4045
4046 **Compatibility:** Firefox 60, Firefox ESR 60\
4047 **CCK2 Equivalent:** `welcomePage`,`noWelcomePage`\
4048 **Preferences Affected:** `startup.homepage_welcome_url`
4049
4050 #### Windows (GPO)
4051 ```
4052 Software\Policies\Mozilla\Firefox\OverrideFirstRunPage = "http://example.org"
4053 ```
4054 #### Windows (Intune)
4055 OMA-URI:
4056 ```
4057 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/OverrideFirstRunPage
4058 ```
4059 Value (string):
4060 ```
4061 <enabled/>
4062 <data id="OverridePage" value="https://example.com"/>
4063 ```
4064 #### macOS
4065 ```
4066 <dict>
4067   <key>OverrideFirstRunPage</key>
4068   <string>http://example.org</string>
4069 </dict>
4070 ```
4071 #### policies.json
4072 ```
4073 {
4074   "policies": {
4075     "OverrideFirstRunPage": "http://example.org"
4076   }
4077 }
4078 ```
4079 ### OverridePostUpdatePage
4080 Override the upgrade page. If the value is an empty string (""), no extra pages are displayed when Firefox is upgraded.
4081
4082 **Compatibility:** Firefox 60, Firefox ESR 60\
4083 **CCK2 Equivalent:** `upgradePage`,`noUpgradePage`\
4084 **Preferences Affected:** `startup.homepage_override_url`
4085
4086 #### Windows (GPO)
4087 ```
4088 Software\Policies\Mozilla\Firefox\OverridePostUpdatePage = "http://example.org"
4089 ```
4090 #### Windows (Intune)
4091 OMA-URI:
4092 ```
4093 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/OverridePostUpdatePage
4094 ```
4095 Value (string):
4096 ```
4097 <enabled/>
4098 <data id="OverridePage" value="https://example.com"/>
4099 ```
4100 #### macOS
4101 ```
4102 <dict>
4103   <key>OverridePostUpdatePage</key>
4104   <string>http://example.org</string>
4105 </dict>
4106 ```
4107 #### policies.json
4108 ```
4109 {
4110   "policies": {
4111     "OverridePostUpdatePage": "http://example.org"
4112   }
4113 }
4114 ```
4115 ### PasswordManagerEnabled
4116 Remove access to the password manager via preferences and blocks about:logins on Firefox 70.
4117
4118 **Compatibility:** Firefox 70, Firefox ESR 60.2\
4119 **CCK2 Equivalent:** N/A\
4120 **Preferences Affected:** `pref.privacy.disable_button.view_passwords`
4121
4122 #### Windows (GPO)
4123 ```
4124 Software\Policies\Mozilla\Firefox\PasswordManagerEnabled = 0x1 | 0x0
4125 ```
4126 #### Windows (Intune)
4127 OMA-URI:
4128 ```
4129 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/PasswordManagerEnabled
4130 ```
4131 Value (string):
4132 ```
4133 <enabled/> or <disabled/>
4134 ```
4135 #### macOS
4136 ```
4137 <dict>
4138   <key>PasswordManagerEnabled</key>
4139   <true/> | <false/>
4140 </dict>
4141 ```
4142 #### policies.json
4143 ```
4144 {
4145   "policies": {
4146     "PasswordManagerEnabled": true | false
4147   }
4148 }
4149 ```
4150 ### PasswordManagerExceptions
4151 Prevent Firefox from saving passwords for specific sites.
4152
4153 The sites are specified as a list of origins.
4154
4155 **Compatibility:** Firefox 101\
4156 **CCK2 Equivalent:** N/A\
4157 **Preferences Affected:** N/A
4158
4159 #### Windows (GPO)
4160 ```
4161 Software\Policies\Mozilla\Firefox\PasswordManagerExceptions\1 = "https://example.org"
4162 Software\Policies\Mozilla\Firefox\PasswordManagerExceptions\2 = "https://example.edu"
4163 ```
4164 #### Windows (Intune)
4165 OMA-URI:
4166 ```
4167 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/PasswordManagerExceptions
4168 ```
4169 Value (string):
4170 ```
4171 <enabled/>
4172 <data id="List" value="1&#xF000;https://example.org&#xF000;2&#xF000;https://example.edu"/>
4173 ```
4174 #### macOS
4175 ```
4176 <dict>
4177   <key>PasswordManagerExceptions</key>
4178   <array>
4179     <string>https://example.org</string>
4180     <string>https://example.edu</string>
4181   </array>
4182 </dict>
4183 ```
4184 #### policies.json
4185 ```
4186 {
4187   "policies": {
4188     "PasswordManagerExceptions": ["https://example.org",
4189                                   "https://example.edu"]
4190   }
4191 }
4192 ```
4193
4194 ### PDFjs
4195 Disable or configure PDF.js, the built-in PDF viewer.
4196
4197 If `Enabled` is set to false, the built-in PDF viewer is disabled.
4198
4199 If `EnablePermissions` is set to true, the built-in PDF viewer will honor document permissions like preventing the copying of text.
4200
4201 Note: DisableBuiltinPDFViewer has not been deprecated. You can either continue to use it, or switch to using PDFjs->Enabled to disable the built-in PDF viewer. This new permission was added because we needed a place for PDFjs->EnabledPermissions.
4202
4203 **Compatibility:** Firefox 77, Firefox ESR 68.9\
4204 **CCK2 Equivalent:** N/A\
4205 **Preferences Affected:** `pdfjs.diabled`, `pdfjs.enablePermissions`
4206
4207 #### Windows (GPO)
4208 ```
4209 Software\Policies\Mozilla\Firefox\PDFjs\Enabled = 0x1 | 0x0
4210 Software\Policies\Mozilla\Firefox\PDFjs\EnablePermissions = 0x1 | 0x0
4211 ```
4212 #### Windows (Intune)
4213 OMA-URI:
4214 ```
4215 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~PDFjs/PDFjs_Enabled
4216 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~PDFjs/PDFjs_EnablePermissions
4217 ```
4218 Value (string):
4219 ```
4220 <enabled/>or <disabled/>
4221 ```
4222 #### macOS
4223 ```
4224 <dict>
4225   <key>PDFjs</key>
4226   <dict>
4227     <key>Enabled</key>
4228     <true/> | <false/>
4229     <key>EnablePermissions</key>
4230     <true/> | <false/>
4231   </dict>
4232 </dict>
4233 ```
4234 #### policies.json
4235 ```
4236 {
4237   "policies": {
4238     "PDFjs": {
4239       "Enabled": true | false,
4240       "EnablePermissions": true | false
4241     }
4242   }
4243 }
4244 ```
4245 ### Permissions
4246 Set permissions associated with camera, microphone, location, notifications, autoplay, and virtual reality. Because these are origins, not domains, entries with unique ports must be specified separately. This explicitly means that it is not possible to add wildcards. See examples below.
4247
4248 `Allow` is a list of origins where the feature is allowed.
4249
4250 `Block` is a list of origins where the feature is not allowed.
4251
4252 `BlockNewRequests` determines whether or not new requests can be made for the feature.
4253
4254 `Locked` prevents the user from changing preferences for the feature.
4255
4256 `Default` specifies the default value for Autoplay. block-audio-video is not supported on Firefox ESR 68.
4257
4258 **Compatibility:** Firefox 62, Firefox ESR 60.2 (Autoplay added in Firefox 74, Firefox ESR 68.6, Autoplay Default/Locked added in Firefox 76, Firefox ESR 68.8, VirtualReality added in Firefox 80, Firefox ESR 78.2)\
4259 **CCK2 Equivalent:** N/A\
4260 **Preferences Affected:** `permissions.default.camera`, `permissions.default.microphone`, `permissions.default.geo`, `permissions.default.desktop-notification`, `media.autoplay.default`, `permissions.default.xr`
4261
4262 #### Windows (GPO)
4263 ```
4264 Software\Policies\Mozilla\Firefox\Permissions\Camera\Allow\1 = "https://example.org"
4265 Software\Policies\Mozilla\Firefox\Permissions\Camera\Allow\2 = "https://example.org:1234"
4266 Software\Policies\Mozilla\Firefox\Permissions\Camera\Block\1 = "https://example.edu"
4267 Software\Policies\Mozilla\Firefox\Permissions\Camera\BlockNewRequests = 0x1 | 0x0
4268 Software\Policies\Mozilla\Firefox\Permissions\Camera\Locked = 0x1 | 0x0
4269 Software\Policies\Mozilla\Firefox\Permissions\Microphone\Allow\1 = "https://example.org"
4270 Software\Policies\Mozilla\Firefox\Permissions\Microphone\Block\1 = "https://example.edu"
4271 Software\Policies\Mozilla\Firefox\Permissions\Microphone\BlockNewRequests = 0x1 | 0x0
4272 Software\Policies\Mozilla\Firefox\Permissions\Microphone\Locked = 0x1 | 0x0
4273 Software\Policies\Mozilla\Firefox\Permissions\Location\Allow\1 = "https://example.org"
4274 Software\Policies\Mozilla\Firefox\Permissions\Location\Block\1 = "https://example.edu"
4275 Software\Policies\Mozilla\Firefox\Permissions\Location\BlockNewRequests = 0x1 | 0x0
4276 Software\Policies\Mozilla\Firefox\Permissions\Location\Locked = 0x1 | 0x0
4277 Software\Policies\Mozilla\Firefox\Permissions\Notifications\Allow\1 = "https://example.org"
4278 Software\Policies\Mozilla\Firefox\Permissions\Notifications\Block\1 = "https://example.edu"
4279 Software\Policies\Mozilla\Firefox\Permissions\Notifications\BlockNewRequests = 0x1 | 0x0
4280 Software\Policies\Mozilla\Firefox\Permissions\Notifications\Locked = 0x1 | 0x0
4281 Software\Policies\Mozilla\Firefox\Permissions\Autoplay\Allow\1 = "https://example.org"
4282 Software\Policies\Mozilla\Firefox\Permissions\Autoplay\Block\1 = "https://example.edu"
4283 Software\Policies\Mozilla\Firefox\Permissions\Autoplay\Default = "allow-audio-video" | "block-audio" | "block-audio-video"
4284 Software\Policies\Mozilla\Firefox\Permissions\Autoplay\Locked = 0x1 | 0x0
4285 Software\Policies\Mozilla\Firefox\Permissions\VirtualReality\Allow\1 = "https://example.org"
4286 Software\Policies\Mozilla\Firefox\Permissions\VirtualReality\Block\1 = "https://example.edu"
4287 Software\Policies\Mozilla\Firefox\Permissions\VirtualReality\BlockNewRequests = 0x1 | 0x0
4288 Software\Policies\Mozilla\Firefox\Permissions\VirtualReality\Locked = 0x1 | 0x0
4289 ```
4290 #### Windows (Intune)
4291 OMA-URI:
4292 ```
4293 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Permissions~Location/Location_BlockNewRequests
4294 ```
4295 Value (string):
4296 ```
4297 <enabled/> or <disabled/>
4298 ```
4299 OMA-URI:
4300 ```
4301 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Permissions~Location/Location_Locked
4302 ```
4303 Value (string):
4304 ```
4305 <enabled/> or <disabled/>
4306 ```
4307 OMA-URI:
4308 ```
4309 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Permissions~Notifications/Notifications_Allow
4310 ```
4311 Value (string):
4312 ```
4313 <enabled/>
4314 <data id="Permissions" value="1&#xF000;https://example.org"/>
4315 ```
4316 OMA-URI:
4317 ```
4318 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Permissions~Notifications/Notifications_BlockNewRequests
4319 ```
4320 Value (string):
4321 ```
4322 <enabled/> or <disabled/>
4323 ```
4324 OMA-URI:
4325 ```
4326 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Permissions~Notifications/Notifications_Locked
4327 ```
4328 Value (string):
4329 ```
4330 <enabled/> or <disabled/>
4331 ```
4332 OMA-URI:
4333 ```
4334 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Permissions~Autoplay/Autoplay_Allow
4335 ```
4336 Value (string):
4337 ```
4338 <enabled/>
4339 <data id="Permissions" value="1&#xF000;https://example.org"/>
4340 ```
4341 OMA-URI:
4342 ```
4343 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Permissions~Autoplay/Autoplay_Block
4344 ```
4345 Value (string):
4346 ```
4347 <enabled/>
4348 <data id="Permissions" value="1&#xF000;https://example.edu"/>
4349 ```
4350 OMA-URI:
4351 ```
4352 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Permissions~Autoplay/Autoplay_Default
4353 ```
4354 Value (string):
4355 ```
4356 <enabled/>
4357 <data id="Autoplay_Default" value="allow-audio-video | block-audio | block-audio-video"/>
4358 ```
4359 OMA-URI:
4360 ```
4361 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Permissions~Autoplay/Autoplay_Locked
4362 ```
4363 Value (string):
4364 ```
4365 <enabled/> or <disabled/>
4366 ```
4367 OMA-URI:
4368 ```
4369 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Permissions~Notifications/VirtualReality_Allow
4370 ```
4371 Value (string):
4372 ```
4373 <enabled/>
4374 <data id="Permissions" value="1&#xF000;https://example.org"/>
4375 ```
4376 OMA-URI:
4377 ```
4378 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Permissions~Notifications/VirtualReality_Block
4379 ```
4380 Value (string):
4381 ```
4382 <enabled/>
4383 <data id="Permissions" value="1&#xF000;https://example.edu"/>
4384 ```
4385 OMA-URI:
4386 ```
4387 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Permissions~Notifications/VirtualReality_BlockNewRequests
4388 ```
4389 Value (string):
4390 ```
4391 <enabled/> or <disabled/>
4392 ```
4393 OMA-URI:
4394 ```
4395 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Permissions~Notifications/VirtualReality_Locked
4396 ```
4397 Value (string):
4398 ```
4399 <enabled/> or <disabled/>
4400 ```
4401 #### macOS
4402 ```
4403 <dict>
4404   <key>Permissions</key>
4405   <dict>
4406     <key>Camera</key>
4407     <dict>
4408       <key>Allow</key>
4409       <array>
4410         <string>https://example.org</string>
4411         <string>https://example.org:1234</string>
4412       </array>
4413       <key>Block</key>
4414       <array>
4415         <string>https://example.edu</string>
4416       </array>
4417       <key>BlockNewRequests</key>
4418       <true/> | <false/>
4419       <key>Locked</key>
4420       <true/> | <false/>
4421     </dict>
4422     <key>Microphone</key>
4423     <dict>
4424       <key>Allow</key>
4425       <array>
4426         <string>https://example.org</string>
4427       </array>
4428       <key>Block</key>
4429       <array>
4430         <string>https://example.edu</string>
4431       </array>
4432       <key>BlockNewRequests</key>
4433       <true/> | <false/>
4434       <key>Locked</key>
4435       <true/> | <false/>
4436     </dict>
4437     <key>Location</key>
4438     <dict>
4439       <key>Allow</key>
4440       <array>
4441         <string>https://example.org</string>
4442       </array>
4443       <key>Block</key>
4444       <array>
4445         <string>https://example.edu</string>
4446       </array>
4447       <key>BlockNewRequests</key>
4448       <true/> | <false/>
4449       <key>Locked</key>
4450       <true/> | <false/>
4451     </dict>
4452     <key>Notifications</key>
4453     <dict>
4454       <key>Allow</key>
4455       <array>
4456         <string>https://example.org</string>
4457       </array>
4458       <key>Block</key>
4459       <array>
4460         <string>https://example.edu</string>
4461       </array>
4462       <key>BlockNewRequests</key>
4463       <true/>
4464       <key>Locked</key>
4465       <true/>
4466     </dict>
4467     <key>Autoplay</key>
4468     <dict>
4469       <key>Allow</key>
4470       <array>
4471         <string>https://example.org</string>
4472       </array>
4473       <key>Block</key>
4474       <array>
4475         <string>https://example.edu</string>
4476       </array>
4477       <key>Default</key>
4478       <string>allow-audio-video | block-audio | block-audio-video</string>
4479       <key>Locked</key>
4480       <true/> | <false/>
4481     </dict>
4482   </dict>
4483 </dict>
4484 ```
4485 #### policies.json
4486 ```
4487 {
4488   "policies": {
4489     "Permissions": {
4490       "Camera": {
4491         "Allow": ["https://example.org","https://example.org:1234"],
4492         "Block": ["https://example.edu"],
4493         "BlockNewRequests": true | false,
4494         "Locked": true | false
4495       },
4496       "Microphone": {
4497         "Allow": ["https://example.org"],
4498         "Block": ["https://example.edu"],
4499         "BlockNewRequests": true | false,
4500         "Locked": true | false
4501       },
4502       "Location": {
4503         "Allow": ["https://example.org"],
4504         "Block": ["https://example.edu"],
4505         "BlockNewRequests": true | false,
4506         "Locked": true | false
4507       },
4508       "Notifications": {
4509         "Allow": ["https://example.org"],
4510         "Block": ["https://example.edu"],
4511         "BlockNewRequests": true | false,
4512         "Locked": true | false
4513       },
4514       "Autoplay": {
4515         "Allow": ["https://example.org"],
4516         "Block": ["https://example.edu"],
4517         "Default": "allow-audio-video" | "block-audio" | "block-audio-video",
4518         "Locked": true | false
4519       }
4520     }
4521   }
4522 }
4523 ```
4524 ### PictureInPicture
4525
4526 Enable or disable Picture-in-Picture as well as prevent the user from enabling or disabling it (Locked).
4527
4528 **Compatibility:** Firefox 78, Firefox ESR 78\
4529 **CCK2 Equivalent:** N/A\
4530 **Preferences Affected:** `media.videocontrols.picture-in-picture.video-toggle.enabled`
4531
4532 #### Windows (GPO)
4533 ```
4534 Software\Policies\Mozilla\Firefox\PictureInPicture\Enabled = 0x1 | 0x0
4535 Software\Policies\Mozilla\Firefox\PictureInPicture\Locked = 0x1 | 0x0
4536
4537 ```
4538 #### Windows (Intune)
4539 OMA-URI:
4540 ```
4541 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~PictureInPicture/PictureInPicture_Enabled
4542 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~PictureInPicture/PictureInPicture_Locked
4543 ```
4544 Value (string):
4545 ```
4546 <enabled/> or <disabled/>
4547 ```
4548 #### macOS
4549 ```
4550 <dict>
4551   <key>PictureInPicture</key>
4552   <dict>
4553     <key>Enabled</key>
4554     <true/> | <false/>
4555     <key>Locked</key>
4556     <true/> | <false/>
4557   </dict>
4558 </dict>
4559 ```
4560 #### policies.json
4561 ```
4562 {
4563   "policies": {
4564     "PictureInPicture": {
4565       "Enabled": true | false,
4566       "Locked": true | false
4567     }
4568   }
4569 }
4570 ```
4571 ### PopupBlocking
4572 Configure the default pop-up window policy as well as origins for which pop-up windows are allowed.
4573
4574 `Allow` is a list of origins where popup-windows are allowed.
4575
4576 `Default` determines whether or not pop-up windows are allowed by default.
4577
4578 `Locked` prevents the user from changing pop-up preferences.
4579
4580 **Compatibility:** Firefox 60, Firefox ESR 60\
4581 **CCK2 Equivalent:** `permissions.popup`\
4582 **Preferences Affected:** `dom.disable_open_during_load`
4583
4584 #### Windows (GPO)
4585 ```
4586 Software\Policies\Mozilla\Firefox\PopupBlocking\Allow\1 = "https://example.org"
4587 Software\Policies\Mozilla\Firefox\PopupBlocking\Allow\2 = "https://example.edu"
4588 Software\Policies\Mozilla\Firefox\PopupBlocking\Default = 0x1 | 0x0
4589 Software\Policies\Mozilla\Firefox\PopupBlocking\Locked = 0x1 | 0x0
4590 ```
4591 #### Windows (Intune)
4592 OMA-URI:
4593 ```
4594 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Popups/PopupBlocking_Allow
4595 ```
4596 Value (string):
4597 ```
4598 <enabled/>
4599 <data id="Permissions" value="1&#xF000;https://example.org&#xF000;2&#xF000;https://example.edu"/>
4600 ```
4601 OMA-URI:
4602 ```
4603 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Popups/PopupBlocking_Default
4604 ```
4605 Value (string):
4606 ```
4607 <enabled/> or <disabled/>
4608 ```
4609 OMA-URI:
4610 ```
4611 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Popups/PopupBlocking_Locked
4612 ```
4613 Value (string):
4614 ```
4615 <enabled/> or <disabled/>
4616 ```
4617 #### macOS
4618 ```
4619 <dict>
4620   <key>PopupBlocking</key>
4621   <dict>
4622     <key>Allow</key>
4623     <array>
4624       <string>http://example.org</string>
4625       <string>http://example.edu</string>
4626     </array>
4627     <key>Default</key>
4628     <true/> | <false/>
4629     <key>Locked</key>
4630     <true/> | <false/>
4631   </dict>
4632 </dict>
4633 ```
4634 #### policies.json
4635 ```
4636 {
4637   "policies": {
4638     "PopupBlocking": {
4639       "Allow": ["http://example.org/",
4640                 "http://example.edu/"],
4641       "Default": true | false,
4642       "Locked": true | false
4643     }
4644   }
4645 }
4646 ```
4647 ### Preferences
4648 Set and lock preferences.
4649
4650 **NOTE** On Windows, in order to use this policy, you must clear all settings in the old **Preferences (Deprecated)** section.
4651
4652 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.
4653
4654 Preferences that start with the following prefixes are supported:
4655 ```
4656 accessibility.
4657 app.update.* (Firefox 86, Firefox 78.8)
4658 browser.
4659 datareporting.policy.
4660 dom.
4661 extensions.
4662 general.autoScroll (Firefox 83, Firefox ESR 78.5)
4663 general.smoothScroll (Firefox 83, Firefox ESR 78.5)
4664 geo.
4665 gfx.
4666 intl.
4667 keyword.enabled (Firefox 95, Firefox ESR 91.4)
4668 layers.
4669 layout.
4670 media.
4671 network.
4672 pdfjs. (Firefox 84, Firefox ESR 78.6)
4673 places.
4674 print.
4675 signon. (Firefox 83, Firefox ESR 78.5)
4676 spellchecker. (Firefox 84, Firefox ESR 78.6)
4677 toolkit.legacyUserProfileCustomizations.stylesheets (Firefox 95, Firefox ESR 91.4)
4678 ui.
4679 widget.
4680 xpinstall.signatures.required (Firefox ESR 102.10, Firefox ESR only)
4681 ```
4682 as well as the following security preferences:
4683
4684 | Preference | Type | Default
4685 | --- | --- | --- |
4686 | security.default_personal_cert | string | Ask Every Time
4687 | &nbsp;&nbsp;&nbsp;&nbsp;If set to Select Automatically, Firefox automatically chooses the default personal certificate.
4688 | security.insecure_connection_text.enabled | bool | false
4689 | &nbsp;&nbsp;&nbsp;&nbsp;If set to true, adds the words "Not Secure" for insecure sites.
4690 | security.insecure_connection_text.pbmode.enabled | bool | false
4691 | &nbsp;&nbsp;&nbsp;&nbsp;If set to true, adds the words "Not Secure" for insecure sites in private browsing.
4692 | security.mixed_content.block_active_content | boolean | true
4693 | &nbsp;&nbsp;&nbsp;&nbsp;If false, mixed active content (HTTP and HTTPS) is not blocked.
4694 | security.osclientcerts.autoload | boolean | false
4695 | &nbsp;&nbsp;&nbsp;&nbsp;If true, client certificates are loaded from the operating system certificate store.
4696 | security.OCSP.enabled | integer | 1
4697 | &nbsp;&nbsp;&nbsp;&nbsp;If 0, do not fetch OCSP. If 1, fetch OCSP for DV and EV certificates. If 2, fetch OCSP only for EV certificates
4698 | security.OCSP.require | boolean | false
4699 | &nbsp;&nbsp;&nbsp;&nbsp; If true, if an OCSP request times out, the connection fails.
4700 | security.osclientcerts.assume_rsa_pss_support | boolean | true
4701 | &nbsp;&nbsp;&nbsp;&nbsp; If false, we don't assume an RSA key can do RSA-PSS (Firefox 114, Firefox ESR 102.12).
4702 | security.ssl.enable_ocsp_stapling | boolean | true
4703 | &nbsp;&nbsp;&nbsp;&nbsp; If false, OCSP stapling is not enabled.
4704 | security.ssl.errorReporting.enabled | boolean | true
4705 | &nbsp;&nbsp;&nbsp;&nbsp;If false, SSL errors cannot be sent to Mozilla.
4706 | security.tls.enable_0rtt_data | boolean | true
4707 | &nbsp;&nbsp;&nbsp;&nbsp;If false, TLS early data is turned off (Firefox 93, Firefox 91.2, Firefox 78.15).
4708 | security.tls.hello_downgrade_check | boolean | true
4709 | &nbsp;&nbsp;&nbsp;&nbsp;If false, the TLS 1.3 downgrade check is disabled.
4710 | security.tls.version.enable-deprecated | boolean | false
4711 | &nbsp;&nbsp;&nbsp;&nbsp;If true, browser will accept TLS 1.0. and TLS 1.1 (Firefox 86, Firefox 78.8).
4712 | security.warn_submit_secure_to_insecure | boolean | true
4713 | &nbsp;&nbsp;&nbsp;&nbsp;If false, no warning is shown when submitting a form from https to http.
4714
4715 Using the preference as the key, set the `Value` to the corresponding preference value.
4716
4717 `Status` can be "default", "locked", "user" or "clear"
4718
4719 * `"default"`: Read/Write: Settings appear as default even if factory default differs.
4720 * `"locked"`: Read-Only: Settings appear as default even if factory default differs.
4721 * `"user"`: Read/Write: Settings appear as changed if it differs from factory default.
4722 * `"clear"`: Read/Write: `Value` has no effect. Resets to factory defaults on each startup.
4723
4724 `"user"` preferences persist across invocations of Firefox. It is the equivalent of a user setting the preference. They are most useful when a preference is needed very early in startup so it can't be set as default by policy. An example of this is ```toolkit.legacyUserProfileCustomizations.stylesheets```.
4725
4726 `"user"` preferences persist even if the policy is removed, so if you need to remove them, you should use the clear policy.
4727
4728 See the examples below for more detail.
4729
4730 IMPORTANT: Make sure you're only setting a particular preference using this mechanism and not some other way.
4731
4732 Status
4733 **Compatibility:** Firefox 81, Firefox ESR 78.3\
4734 **CCK2 Equivalent:** `preferences`\
4735 **Preferences Affected:** Many
4736
4737 #### Windows (GPO)
4738 Software\Policies\Mozilla\Firefox\Preferences (REG_MULTI_SZ) =
4739 ```
4740 {
4741   "accessibility.force_disabled": {
4742     "Value": 1,
4743     "Status": "default"
4744   },
4745   "browser.cache.disk.parent_directory": {
4746     "Value": "SOME_NATIVE_PATH",
4747     "Status": "user"
4748   },
4749   "browser.tabs.warnOnClose": {
4750     "Value": false,
4751     "Status": "locked"
4752   }
4753 }
4754 ```
4755 #### Windows (Intune)
4756 OMA-URI:
4757 ```
4758 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/Preferences
4759 ```
4760 Value (string):
4761 ```
4762 <enabled/>
4763 <data id="JSON" value='
4764 {
4765   "accessibility.force_disabled": {
4766     "Value": 1,
4767     "Status": "default"
4768   },
4769   "browser.cache.disk.parent_directory": {
4770     "Value": "SOME_NATIVE_PATH",
4771     "Status": "user"
4772   },
4773   "browser.tabs.warnOnClose": {
4774     "Value": false,
4775     "Status": "locked"
4776   }
4777 }'/>
4778 ```
4779 #### macOS
4780 ```
4781 <dict>
4782   <key>Preferences</key>
4783   <dict>
4784     <key>accessibility.force_disabled</key>
4785     <dict>
4786       <key>Value</key>
4787       <integer>1</integer>
4788       <key>Status</key>
4789       <string>default</string>
4790     </dict>
4791     <key>browser.cache.disk.parent_directory</key>
4792     <dict>
4793       <key>Value</key>
4794       <string>SOME_NATIVE_PATH</string>
4795       <key>Status</key>
4796       <string>user</string>
4797     </dict>
4798     <key>browser.tabs.warnOnClose</key>
4799     <dict>
4800       <key>Value</key>
4801       <false/>
4802       <key>Status</key>
4803       <string>locked</string>
4804     </dict>
4805   </dict>
4806 </dict>
4807 ```
4808 #### policies.json
4809 ```
4810 {
4811   "policies": {
4812     "Preferences": {
4813       "accessibility.force_disabled": {
4814         "Value": 1,
4815         "Status": "default"
4816       },
4817       "browser.cache.disk.parent_directory": {
4818         "Value": "SOME_NATIVE_PATH",
4819         "Status": "user"
4820       },
4821       "browser.tabs.warnOnClose": {
4822         "Value": false,
4823         "Status": "locked"
4824       }
4825     }
4826   }
4827 }
4828 ```
4829 ### Preferences (Deprecated)
4830 Set and lock certain preferences.
4831
4832 **Compatibility:** See below\
4833 **CCK2 Equivalent:** `preferences`\
4834 **Preferences Affected:** See below
4835
4836 | Preference | Type | Compatibility | Default
4837 | --- | --- | --- | --- |
4838 | accessibility.force_disabled | integer | Firefox 70, Firefox ESR 68.2 | 0 | &nbsp;&nbsp;&nbsp;&nbsp;If set to 1, platform accessibility is disabled.
4839 | app.update.auto (Deprecated - Switch to AppAutoUpdate policy) | boolean | Firefox 68, Firefox ESR 68 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, Firefox doesn't automatically install update.
4840 | browser.bookmarks.autoExportHTML | boolean | Firefox 70, Firefox ESR 68.2 | false | &nbsp;&nbsp;&nbsp;&nbsp;If true, bookmarks are exported on shutdown.
4841 | browser.bookmarks.file | string | Firefox 70, Firefox ESR 68.2 | N/A | &nbsp;&nbsp;&nbsp;&nbsp;If set, the name of the file where bookmarks are exported and imported.
4842 | browser.bookmarks.restore_default_bookmarks | boolean | Firefox 70, Firefox ESR 68.2 | N/A | &nbsp;&nbsp;&nbsp;&nbsp;If true, bookmarks are restored to their defaults.
4843 | browser.cache.disk.enable | boolean | Firefox 68, Firefox ESR 68 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, don't store cache on the hard drive.
4844 | ~browser.cache.disk.parent_directory~ | string | Firefox 68, Firefox ESR 68 | Profile temporary directory | &nbsp;&nbsp;&nbsp;&nbsp;~If set, changes the location of the disk cache.~ This policy doesn't work. It's being worked on.
4845 | browser.fixup.dns_first_for_single_words | boolean | Firefox 68, Firefox ESR 68 | false | &nbsp;&nbsp;&nbsp;&nbsp;If true, single words are sent to DNS, not directly to search.
4846 | browser.newtabpage.activity-stream.default.sites | string | Firefox 72, ESR 68.4 | Locale dependent | &nbsp;&nbsp;&nbsp;&nbsp;If set, a list of URLs to use as the default top sites on the new tab page. Due to Firefox limitations, search sites can't be added. In addition, sites with the same name but different TLDs (example.org/example.com) will not display properly.
4847 | browser.places.importBookmarksHTML | boolean | Firefox 70, Firefox ESR 68.2 | &nbsp;&nbsp;&nbsp;&nbsp;If true, bookmarks are always imported on startup.
4848 | browser.safebrowsing.phishing.enabled | boolean | Firefox 70, Firefox ESR 68.2 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, phishing protection is not enabled (Not recommended)
4849 | browser.safebrowsing.malware.enabled | boolean | Firefox 70, Firefox ESR 68.2 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, malware protection is not enabled (Not recommended)
4850 | browser.search.update | boolean | Firefox 68, Firefox ESR 68 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, updates for search engines are not checked.
4851 | browser.slowStartup.notificationDisabled | boolean | Firefox 70, Firefox ESR 68.2 | false | &nbsp;&nbsp;&nbsp;&nbsp;If true, a notification isn't shown if startup is slow.
4852 | browser.tabs.warnOnClose | boolean | Firefox 68, Firefox ESR 68 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, there is no warning when the browser is closed.
4853 | browser.taskbar.previews.enable | boolean | Firefox 70, Firefox ESR 68.2 (Windows only) | false | &nbsp;&nbsp;&nbsp;&nbsp;If true, tab previews are shown in the Windows taskbar.
4854 | browser.urlbar.suggest.bookmark | boolean | Firefox 68, Firefox ESR 68 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, bookmarks aren't suggested when typing in the URL bar.
4855 | browser.urlbar.suggest.history | boolean | Firefox 68, Firefox ESR 68 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, history isn't suggested when typing in the URL bar.
4856 | browser.urlbar.suggest.openpage | boolean | Firefox 68, Firefox ESR 68 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, open tabs aren't suggested when typing in the URL bar.
4857 | datareporting.policy.dataSubmissionPolicyBypassNotification | boolean | Firefox 68, Firefox ESR 68 | false | &nbsp;&nbsp;&nbsp;&nbsp;If true, don't show the privacy policy tab on first run.
4858 | dom.allow_scripts_to_close_windows | boolean | Firefox 70, Firefox ESR 68.2 | false | &nbsp;&nbsp;&nbsp;&nbsp;If false, web page can close windows.
4859 | dom.disable_window_flip | boolean | Firefox 68, Firefox ESR 68 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, web pages can focus and activate windows.
4860 | dom.disable_window_move_resize | boolean | Firefox 68, Firefox ESR 68 | false | &nbsp;&nbsp;&nbsp;&nbsp;If true, web pages can't move or resize windows.
4861 | dom.event.contextmenu.enabled | boolean | Firefox 68, Firefox ESR 68 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, web pages can't override context menus.
4862 | dom.keyboardevent.keypress.hack.dispatch_non_printable_keys.addl | string | Firefox 68, Firefox ESR 68 | N/A | &nbsp;&nbsp;&nbsp;&nbsp;See https://support.mozilla.org/en-US/kb/dom-events-changes-introduced-firefox-66
4863 | dom.keyboardevent.keypress.hack.use_legacy_keycode_and_charcode.addl | string | Firefox 68, Firefox ESR 68 | N/A | &nbsp;&nbsp;&nbsp;&nbsp;See https://support.mozilla.org/en-US/kb/dom-events-changes-introduced-firefox-66
4864 | dom.xmldocument.load.enabled | boolean | Firefox ESR 68.5 | true. | &nbsp;&nbsp;&nbsp;&nbsp;If false, XMLDocument.load is not available.
4865 | dom.xmldocument.async.enabled | boolean | Firefox ESR 68.5 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, XMLDocument.async is not available.
4866 | extensions.blocklist.enabled | boolean | Firefox 70, Firefox ESR 68.2 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, the extensions blocklist is not used (Not recommended)
4867 | extensions.getAddons.showPane | boolean | Firefox 68, Firefox ESR 68 | N/A | &nbsp;&nbsp;&nbsp;&nbsp;If false, the Recommendations tab is not displayed in the Add-ons Manager.
4868 | extensions.htmlaboutaddons.recommendations.enabled | boolean | Firefox 72, Firefox ESR 68.4 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, recommendations are not shown on the Extensions tab in the Add-ons Manager.
4869 | geo.enabled | boolean | Firefox 70, Firefox ESR 68.2 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, the geolocation API is disabled. | Language dependent
4870 | intl.accept_languages | string | Firefox 70, Firefox ESR 68.2 | &nbsp;&nbsp;&nbsp;&nbsp;If set, preferred language for web pages.
4871 | media.eme.enabled (Deprecated - Switch to EncryptedMediaExtensions policy) | boolean | Firefox 70, Firefox ESR 68.2 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, Encrypted Media Extensions are not enabled.
4872 | media.gmp-gmpopenh264.enabled | boolean | Firefox 68, Firefox ESR 68 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, the OpenH264  plugin is not downloaded.
4873 | media.gmp-widevinecdm.enabled | boolean | Firefox 68, Firefox ESR 68 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, the Widevine plugin is not downloaded.
4874 | media.peerconnection.enabled | boolean | Firefox 72, Firefox ESR 68.4 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, WebRTC is disabled
4875 | media.peerconnection.ice.obfuscate_host_addresses.whitelist (Deprecated) | string | Firefox 72, Firefox ESR 68.4 | N/A | &nbsp;&nbsp;&nbsp;&nbsp;If set, a list of domains for which mDNS hostname obfuscation is
4876 disabled
4877 | media.peerconnection.ice.obfuscate_host_addresses.blocklist | string | Firefox 79, Firefox ESR 78.1 | N/A | &nbsp;&nbsp;&nbsp;&nbsp;If set, a list of domains for which mDNS hostname obfuscation is
4878 disabled
4879 | network.dns.disableIPv6 | boolean | Firefox 68, Firefox ESR 68 | false | &nbsp;&nbsp;&nbsp;&nbsp;If true, IPv6 DNS lokoups are disabled.
4880 | network.IDN_show_punycode | boolean | Firefox 68, Firefox ESR 68 | false | &nbsp;&nbsp;&nbsp;&nbsp;If true, display the punycode version of internationalized domain names.
4881 | places.history.enabled | boolean | Firefox 68, Firefox ESR 68 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, history is not enabled.
4882 | print.save_print_settings | boolean | Firefox 70, Firefox ESR 68.2 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, print settings are not saved between jobs.
4883 | security.default_personal_cert | string | Firefox 68, Firefox ESR 68 | Ask Every Time | &nbsp;&nbsp;&nbsp;&nbsp;If set to Select Automatically, Firefox automatically chooses the default personal certificate.
4884 | security.mixed_content.block_active_content | boolean | Firefox 70, Firefox ESR 68.2 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, mixed active content (HTTP and HTTPS) is not blocked.
4885 | security.osclientcerts.autoload | boolean | Firefox 72 (Windows), Firefox 75 (macOS)  | false | &nbsp;&nbsp;&nbsp;&nbsp;If true, client certificates are loaded from the operating system certificate store.
4886 | security.ssl.errorReporting.enabled | boolean | Firefox 68, Firefox ESR 68 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, SSL errors cannot be sent to Mozilla.
4887 | security.tls.hello_downgrade_check | boolean | Firefox 72, Firefox ESR 68.4 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, the TLS 1.3 downgrade check is disabled.
4888 | ui.key.menuAccessKeyFocuses | boolean | Firefox 68, Firefox ESR 68 | true | &nbsp;&nbsp;&nbsp;&nbsp;If false, the Alt key doesn't show the menubar on Windows.
4889 | widget.content.gtk-theme-override | string | Firefox 72, Firefox ESR 68.4 (Linux only) | N/A | &nbsp;&nbsp;&nbsp;&nbsp;If set, overrides the GTK theme for widgets.
4890
4891 #### Windows (GPO)
4892 ```
4893 Software\Policies\Mozilla\Firefox\Preferences\boolean_preference_name = 0x1 | 0x0
4894 Software\Policies\Mozilla\Firefox\Preferences\string_preference_name = "string_value"
4895 ```
4896 #### Windows (Intune)
4897 OMA-URI: (periods are replaced by underscores)
4898 ```
4899 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Preferences/boolean_preference_name
4900 ```
4901 Value (string):
4902 ```
4903 <enabled/> or <disabled/>
4904 ```
4905 OMA-URI: (periods are replaced by underscores)
4906 ```
4907 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Preferences/string_preference_name
4908 ```
4909 Value (string):
4910 ```
4911 <enabled/>
4912 <data id="Preferences_String" value="string_value"/>
4913 ```
4914 #### macOS
4915 ```
4916 <dict>
4917   <key>Preferences</key>
4918   <dict>
4919     <key>boolean_preference_name</key>
4920     <true/> | <false/>
4921     <key>string_preference_name</key>
4922     <string>string_value</string>
4923   </dict>
4924 </dict>
4925 ```
4926 #### policies.json
4927 ```
4928 {
4929   "policies": {
4930     "Preferences": {
4931       "boolean_preference_name": true | false,
4932       "string_preference_name": "string_value"
4933     }
4934   }
4935 }
4936 ```
4937 ### PrimaryPassword
4938 Require or prevent using a primary (formerly master) password.
4939
4940 If this value is true, a primary password is required. If this value is false, it works the same as if [`DisableMasterPasswordCreation`](#disablemasterpasswordcreation) was true and removes the primary password functionality.
4941
4942 If both DisableMasterPasswordCreation and PrimaryPassword are used, DisableMasterPasswordCreation takes precedent.
4943
4944 **Compatibility:** Firefox 79, Firefox ESR 78.1\
4945 **CCK2 Equivalent:** `noMasterPassword`\
4946 **Preferences Affected:** N/A
4947
4948 #### Windows (GPO)
4949 ```
4950 Software\Policies\Mozilla\Firefox\PrimaryPassword = 0x1 | 0x0
4951 ```
4952 #### Windows (Intune)
4953 OMA-URI:
4954 ```
4955 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/PrimaryPassword
4956 ```
4957 Value (string):
4958 ```
4959 <enabled/> or <disabled/>
4960 ```
4961 #### macOS
4962 ```
4963 <dict>
4964   <key>PrimaryPassword</key>
4965   <true/> | <false/>
4966 </dict>
4967 ```
4968 #### policies.json
4969 ```
4970 {
4971   "policies": {
4972     "PrimaryPassword": true | false
4973   }
4974 }
4975 ```
4976 ### PromptForDownloadLocation
4977 Ask where to save each file before downloading.
4978
4979 **Compatibility:** Firefox 68, Firefox ESR 68\
4980 **CCK2 Equivalent:** N/A\
4981 **Preferences Affected:** `browser.download.useDownloadDir`
4982
4983 #### Windows (GPO)
4984 ```
4985 Software\Policies\Mozilla\Firefox\PromptForDownloadLocation = 0x1 | 0x0
4986 ```
4987 #### Windows (Intune)
4988 OMA-URI:
4989 ```
4990 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/PromptForDownloadLocation
4991 ```
4992 Value (string):
4993 ```
4994 <enabled/> or <disabled/>
4995 ```
4996 #### macOS
4997 ```
4998 <dict>
4999   <key>PromptForDownloadLocation</key>
5000   <true/> | <false/>
5001 </dict>
5002 ```
5003 #### policies.json
5004 ```
5005 {
5006   "policies": {
5007     "PromptForDownloadLocation": true | false
5008   }
5009 }
5010 ```
5011 ### Proxy
5012 Configure proxy settings. These settings correspond to the connection settings in Firefox preferences.
5013 To specify ports, append them to the hostnames with a colon (:).
5014
5015 Unless you lock this policy, changes the user already has in place will take effect.
5016
5017 `Mode` is the proxy method being used.
5018
5019 `Locked` is whether or not proxy settings can be changed.
5020
5021 `HTTPProxy` is the HTTP proxy server.
5022
5023 `UseHTTPProxyForAllProtocols` is whether or not the HTTP proxy should be used for all other proxies.
5024
5025 `SSLProxy` is the SSL proxy server.
5026
5027 `FTPProxy` is the FTP proxy server.
5028
5029 `SOCKSProxy` is the SOCKS proxy server
5030
5031 `SOCKSVersion` is the SOCKS version (4 or 5)
5032
5033 `Passthrough` is list of hostnames or IP addresses that will not be proxied. Use `<local>` to bypass proxying for all hostnames which do not contain periods.
5034
5035 `AutoConfigURL` is a  URL for proxy configuration (only used if Mode is autoConfig).
5036
5037 `AutoLogin` means do not prompt for authentication if password is saved.
5038
5039 `UseProxyForDNS` to use proxy DNS when using SOCKS v5.
5040
5041 **Compatibility:** Firefox 60, Firefox ESR 60\
5042 **CCK2 Equivalent:** `networkProxy*`\
5043 **Preferences Affected:** `network.proxy.type`, `network.proxy.autoconfig_url`, `network.proxy.socks_remote_dns`, `signon.autologin.proxy`, `network.proxy.socks_version`, `network.proxy.no_proxies_on`, `network.proxy.share_proxy_settings`, `network.proxy.http`, `network.proxy.http_port`, `network.proxy.ftp`, `network.proxy.ftp_port`, `network.proxy.ssl`, `network.proxy.ssl_port`, `network.proxy.socks`, `network.proxy.socks_port`
5044
5045 #### Windows (GPO)
5046 ```
5047 Software\Policies\Mozilla\Firefox\Proxy\Mode = "none" | "system" | "manual" | "autoDetect" | "autoConfig"
5048 Software\Policies\Mozilla\Firefox\Proxy\Locked = 0x1 | 0x0
5049 Software\Policies\Mozilla\Firefox\=Proxy\HTTPProxy = https://httpproxy.example.com
5050 Software\Policies\Mozilla\Firefox\Proxy\UseHTTPProxyForAllProtocols = 0x1 | 0x0
5051 Software\Policies\Mozilla\Firefox\Proxy\SSLProxy = https://sslproxy.example.com
5052 Software\Policies\Mozilla\Firefox\Proxy\FTPProxy = https://ftpproxy.example.com
5053 Software\Policies\Mozilla\Firefox\Proxy\SOCKSProxy = https://socksproxy.example.com
5054 Software\Policies\Mozilla\Firefox\Proxy\SOCKSVersion = 0x4 | 0x5
5055 Software\Policies\Mozilla\Firefox\Proxy\Passthrough = <local>
5056 Software\Policies\Mozilla\Firefox\Proxy\AutoConfigURL = URL_TO_AUTOCONFIG
5057 Software\Policies\Mozilla\Firefox\Proxy\AutoLogin = 0x1 | 0x0
5058 Software\Policies\Mozilla\Firefox\Proxy\UseProxyForDNS = 0x1 | 0x0
5059 ```
5060 #### Windows (Intune)
5061 **Note**
5062 These setttings were moved to a category to make them easier to configure via Intune.
5063
5064 OMA-URI:
5065 ```
5066 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~ProxySettings/Proxy_Locked
5067 ```
5068 Value (string):
5069 ```
5070 <enabled/> or <disabled/>
5071 ```
5072 OMA-URI:
5073 ```
5074 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~ProxySettings/Proxy_ConnectionType
5075 ```
5076 Value (string):
5077 ```
5078 <enabled/>
5079 <data id="Proxy_ConnectionType" value="none | system | manual | autoDetect | autoConfig"/>
5080 ```
5081 OMA-URI:
5082 ```
5083 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~ProxySettings/Proxy_HTTPProxy
5084 ```
5085 Value (string):
5086 ```
5087 <enabled/>
5088 <data id="Proxy_HTTPProxy" value="httpproxy.example.com"/>
5089 ```
5090 OMA-URI:
5091 ```
5092 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~ProxySettings/Proxy_UseHTTPProxyForAllProtocols
5093 ```
5094 Value (string):
5095 ```
5096 <enabled/> or <disabled/>
5097 ```
5098 OMA-URI:
5099 ```
5100 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~ProxySettings/Proxy_SSLProxy
5101 ```
5102 Value (string):
5103 ```
5104 <enabled/>
5105 <data id="Proxy_SSLProxy" value="sslproxy.example.com"/>
5106 ```
5107 OMA-URI:
5108 ```
5109 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~ProxySettings/Proxy_SOCKSProxy
5110 ```
5111 Value (string):
5112 ```
5113 <enabled/>
5114 <data id="Proxy_SOCKSProxy" value="socksproxy.example.com"/>
5115 <data id="Proxy_SOCKSVersion" value="4 | 5"/>
5116 ```
5117 OMA-URI:
5118 ```
5119 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~ProxySettings/Proxy_AutoConfigURL
5120 ```
5121 Value (string):
5122 ```
5123 <enabled/>
5124 <data id="Proxy_AutoConfigURL" value="URL_TO_AUTOCONFIG"/>
5125 ```
5126 OMA-URI:
5127 ```
5128 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~ProxySettings/Proxy_Passthrough
5129 ```
5130 Value (string):
5131 ```
5132 <enabled/>
5133 <data id="Proxy_Passthrough" value="&lt;local&gt;"/>
5134 ```
5135 OMA-URI:
5136 ```
5137 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~ProxySettings/Proxy_AutoLogin
5138 ```
5139 Value (string):
5140 ```
5141 <enabled/> or <disabled/>
5142 ```
5143 OMA-URI:
5144 ```
5145 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~ProxySettings/Proxy_UseProxyForDNS
5146 ```
5147 Value (string):
5148 ```
5149 <enabled/> or <disabled/>
5150 ```
5151 OMA-URI (Old way):
5152 ```
5153 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/Proxy
5154 ```
5155 Value (string):
5156 ```
5157 <enabled/>
5158 <data id="ProxyLocked" value="true | false"/>
5159 <data id="ConnectionType" value="none | system | manual | autoDetect | autoConfig"/>
5160 <data id="HTTPProxy" value="httpproxy.example.com"/>
5161 <data id="UseHTTPProxyForAllProtocols" value="true | false"/>
5162 <data id="SSLProxy" value="sslproxy.example.com"/>
5163 <data id="FTPProxy" value="ftpproxy.example.com"/>
5164 <data id="SOCKSProxy" value="socksproxy.example.com"/>
5165 <data id="SOCKSVersion" value="4 | 5"/>
5166 <data id="AutoConfigURL" value="URL_TO_AUTOCONFIG"/>
5167 <data id="Passthrough" value="<local>"/>
5168 <data id="AutoLogin" value="true | false"/>
5169 <data id="UseProxyForDNS" value="true | false"/>
5170 ```
5171 #### macOS
5172 ```
5173 <dict>
5174   <key>Proxy</key>
5175   <dict>
5176     <key>Mode</key>
5177     <string>none | system | manual | autoDetect | autoConfig</string>
5178     <key>Locked</key>
5179     <true> | </false>
5180     <key>HTTPProxy</key>
5181     <string>https://httpproxy.example.com</string>
5182     <key>UseHTTPProxyForAllProtocols</key>
5183     <true> | </false>
5184     <key>SSLProxy</key>
5185     <string>https://sslproxy.example.com</string>
5186     <key>FTPProxy</key>
5187     <string>https://ftpproxy.example.com</string>
5188     <key>SOCKSProxy</key>
5189     <string>https://socksproxy.example.com</string>
5190     <key>SOCKSVersion</key>
5191     <string>4 | 5</string>
5192     <key>Passthrough</key>
5193     <string>&lt;local>&gt;</string>
5194     <key>AutoConfigURL</key>
5195     <string>URL_TO_AUTOCONFIG</string>
5196     <key>AutoLogin</key>
5197     <true> | </false>
5198     <key>UseProxyForDNS</key>
5199     <true> | </false>
5200   </dict>
5201 </dict>
5202 ```
5203 #### policies.json
5204 ```
5205 {
5206   "policies": {
5207     "Proxy": {
5208       "Mode": "none" | "system" | "manual" | "autoDetect" | "autoConfig",
5209       "Locked": true | false,
5210       "HTTPProxy": "hostname",
5211       "UseHTTPProxyForAllProtocols": true | false,
5212       "SSLProxy": "hostname",
5213       "FTPProxy": "hostname",
5214       "SOCKSProxy": "hostname",
5215       "SOCKSVersion": 4 | 5,
5216       "Passthrough": "<local>",
5217       "AutoConfigURL": "URL_TO_AUTOCONFIG",
5218       "AutoLogin": true | false,
5219       "UseProxyForDNS": true | false
5220     }
5221   }
5222 }
5223 ```
5224 ### RequestedLocales
5225 Set the the list of requested locales for the application in order of preference. It will cause the corresponding language pack to become active.
5226
5227 Note: For Firefox 68, this can now be a string so that you can specify an empty value.
5228
5229 **Compatibility:** Firefox 64, Firefox ESR 60.4, Updated in Firefox 68, Firefox ESR 68\
5230 **CCK2 Equivalent:** N/A\
5231 **Preferences Affected:** N/A
5232 #### Windows (GPO)
5233 ```
5234 Software\Policies\Mozilla\Firefox\RequestedLocales\1 = "de"
5235 Software\Policies\Mozilla\Firefox\RequestedLocales\2 = "en-US"
5236
5237 or
5238
5239 Software\Policies\Mozilla\Firefox\RequestedLocales = "de,en-US"
5240 ```
5241 #### Windows (Intune)
5242 OMA-URI:
5243 ```
5244 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/RequestedLocalesString
5245 ```
5246 Value (string):
5247 ```
5248 <enabled/>
5249 <data id="Preferences_String" value="de,en-US"/>
5250 ```
5251 #### macOS
5252 ```
5253 <dict>
5254   <key>RequestedLocales</key>
5255   <array>
5256     <string>de</string>
5257     <string>en-US</string>
5258   </array>
5259 </dict>
5260
5261 or
5262
5263 <dict>
5264   <key>RequestedLocales</key>
5265   <string>de,en-US</string>
5266 </dict>
5267
5268 ```
5269 #### policies.json
5270 ```
5271 {
5272   "policies": {
5273     "RequestedLocales": ["de", "en-US"]
5274   }
5275 }
5276
5277 or
5278
5279 {
5280   "policies": {
5281     "RequestedLocales": "de,en-US"
5282   }
5283 }
5284 ```
5285 <a name="SanitizeOnShutdown"></a>
5286
5287 ### SanitizeOnShutdown (Selective)
5288 Clear data on shutdown. Choose from Cache, Cookies, Download History, Form & Search History, Browsing History, Active Logins, Site Preferences and Offline Website Data.
5289
5290 Previously, these values were always locked. Starting with Firefox 74 and Firefox ESR 68.6, you can use the `Locked` option to either keep the values unlocked (set it to false), or lock only the values you set (set it to true). If you want the old behavior of locking everything, do not set `Locked` at all.
5291
5292 **Compatibility:** Firefox 68, Firefox ESR 68 (Locked added in 74/68.6)\
5293 **CCK2 Equivalent:** N/A\
5294 **Preferences Affected:** `privacy.sanitize.sanitizeOnShutdown`, `privacy.clearOnShutdown.cache`, `privacy.clearOnShutdown.cookies`, `privacy.clearOnShutdown.downloads`, `privacy.clearOnShutdown.formdata`, `privacy.clearOnShutdown.history`, `privacy.clearOnShutdown.sessions`, `privacy.clearOnShutdown.siteSettings`, `privacy.clearOnShutdown.offlineApps`
5295 #### Windows (GPO)
5296 ```
5297 Software\Policies\Mozilla\Firefox\SanitizeOnShutdown\Cache = 0x1 | 0x0
5298 Software\Policies\Mozilla\Firefox\SanitizeOnShutdown\Cookies = 0x1 | 0x0
5299 Software\Policies\Mozilla\Firefox\SanitizeOnShutdown\Downloads = 0x1 | 0x0
5300 Software\Policies\Mozilla\Firefox\SanitizeOnShutdown\FormData = 0x1 | 0x0
5301 Software\Policies\Mozilla\Firefox\SanitizeOnShutdown\History = 0x1 | 0x0
5302 Software\Policies\Mozilla\Firefox\SanitizeOnShutdown\Sessions = 0x1 | 0x0
5303 Software\Policies\Mozilla\Firefox\SanitizeOnShutdown\SiteSettings = 0x1 | 0x0
5304 Software\Policies\Mozilla\Firefox\SanitizeOnShutdown\OfflineApps = 0x1 | 0x0
5305 Software\Policies\Mozilla\Firefox\SanitizeOnShutdown\Locked = 0x1 | 0x0
5306 ```
5307 #### Windows (Intune)
5308 OMA-URI:
5309 ```
5310 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~SanitizeOnShutdown/A_SanitizeOnShutdown_Cache
5311 ```
5312 Value (string):
5313 ```
5314 <enabled/> or <disabled/>
5315 ```
5316 OMA-URI:
5317 ```
5318 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~SanitizeOnShutdown/B_SanitizeOnShutdown_Cookies
5319 ```
5320 Value (string):
5321 ```
5322 <enabled/> or <disabled/>
5323 ```
5324 OMA-URI:
5325 ```
5326 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~SanitizeOnShutdown/C_SanitizeOnShutdown_Downloads
5327 ```
5328 Value (string):
5329 ```
5330 <enabled/> or <disabled/>
5331 ```
5332 OMA-URI:
5333 ```
5334 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~SanitizeOnShutdown/D_SanitizeOnShutdown_FormData
5335 ```
5336 Value (string):
5337 ```
5338 <enabled/> or <disabled/>
5339 ```
5340 OMA-URI:
5341 ```
5342 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~SanitizeOnShutdown/E_SanitizeOnShutdown_History
5343 ```
5344 Value (string):
5345 ```
5346 <enabled/> or <disabled/>
5347 ```
5348 OMA-URI:
5349 ```
5350 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~SanitizeOnShutdown/F_SanitizeOnShutdown_Sessions
5351 ```
5352 Value (string):
5353 ```
5354 <enabled/> or <disabled/>
5355 ```
5356 OMA-URI:
5357 ```
5358 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~SanitizeOnShutdown/G_SanitizeOnShutdown_SiteSettings
5359 ```
5360 Value (string):
5361 ```
5362 <enabled/> or <disabled/>
5363 ```
5364 OMA-URI:
5365 ```
5366 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~SanitizeOnShutdown/H_SanitizeOnShutdown_OfflineApps
5367 ```
5368 Value (string):
5369 ```
5370 <enabled/> or <disabled/>
5371 ```
5372 OMA-URI:
5373 ```
5374 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~SanitizeOnShutdown/I_SanitizeOnShutdown_Locked
5375 ```
5376 Value (string):
5377 ```
5378 <enabled/> or <disabled/>
5379 ```
5380 #### macOS
5381 ```
5382 <dict>
5383   <key>SanitizeOnShutdown</key>
5384   <dict>
5385     <key>Cache</key>
5386     <true/> | <false/>
5387     <key>Cookies</key>
5388     <true/> | <false/>
5389     <key>Downloads</key>
5390     <true/> | <false/>
5391     <key>FormData</key>
5392     <true/> | <false/>
5393     <key>History</key>
5394     <true/> | <false/>
5395     <key>Sessions</key>
5396     <true/> | <false/>
5397     <key>SiteSettings</key>
5398     <true/> | <false/>
5399     <key>OfflineApps</key>
5400     <true/> | <false/>
5401     <key>Locked</key>
5402     <true/> | <false/>
5403   </dict>
5404 </dict>
5405 ```
5406 #### policies.json
5407 ```
5408 {
5409   "policies": {
5410     "SanitizeOnShutdown": {
5411       "Cache": true | false,
5412       "Cookies": true | false,
5413       "Downloads": true | false,
5414       "FormData": true | false,
5415       "History": true | false,
5416       "Sessions": true | false,
5417       "SiteSettings": true | false,
5418       "OfflineApps": true | false,
5419       "Locked": true | false
5420     }
5421   }
5422 }
5423 ```
5424 ### SanitizeOnShutdown (All)
5425 Clear all data on shutdown, including Browsing & Download History, Cookies, Active Logins, Cache, Form & Search History, Site Preferences and Offline Website Data.
5426
5427 **Compatibility:** Firefox 60, Firefox ESR 60\
5428 **CCK2 Equivalent:** N/A\
5429 **Preferences Affected:** `privacy.sanitize.sanitizeOnShutdown`, `privacy.clearOnShutdown.cache`, `privacy.clearOnShutdown.cookies`, `privacy.clearOnShutdown.downloads`, `privacy.clearOnShutdown.formdata`, `privacy.clearOnShutdown.history`, `privacy.clearOnShutdown.sessions`, `privacy.clearOnShutdown.siteSettings`, `privacy.clearOnShutdown.offlineApps`
5430 #### Windows (GPO)
5431 ```
5432 Software\Policies\Mozilla\Firefox\SanitizeOnShutdown = 0x1 | 0x0
5433 ```
5434 #### Windows (Intune)
5435 OMA-URI:
5436 ```
5437 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/C_SanitizeOnShutdown
5438 ```
5439 Value (string):
5440 ```
5441 <enabled/> or <disabled/>
5442 ```
5443 #### macOS
5444 ```
5445 <dict>
5446   <key>SanitizeOnShutdown</key>
5447   <true/> | <false/>
5448 </dict>
5449 ```
5450 #### policies.json
5451 ```
5452 {
5453   "policies": {
5454     "SanitizeOnShutdown": true | false
5455   }
5456 }
5457 ```
5458 ### SearchBar
5459 Set whether or not search bar is displayed.
5460
5461 **Compatibility:** Firefox 60, Firefox ESR 60\
5462 **CCK2 Equivalent:** `showSearchBar`\
5463 **Preferences Affected:** N/A
5464
5465 #### Windows (GPO)
5466 ```
5467 Software\Policies\Mozilla\Firefox\SearchBar = "unified" | "separate"
5468 ```
5469
5470 #### Windows (Intune)
5471 OMA-URI:
5472 ```
5473 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/SearchBar
5474 ```
5475 Value (string):
5476 ```
5477 <enabled/>
5478 <data id="SearchBar" value="unified | separate"/>
5479 ```
5480 #### macOS
5481 ```
5482 <dict>
5483   <key>SearchBar</key>
5484   <string>unified | separate</string>
5485 </dict>
5486 ```
5487 #### policies.json
5488 ```
5489 {
5490   "policies": {
5491     "SearchBar": "unified" | "separate"
5492   }
5493 }
5494 ```
5495 <a name="SearchEngines"></a>
5496
5497 ### SearchEngines (This policy is only available on the ESR.)
5498
5499 ### SearchEngines | Add
5500
5501 Add new search engines. Although there are only five engines available in the ADMX template, there is no limit. To add more in the ADMX template, you can duplicate the XML.
5502
5503 This policy is only available on the ESR. `Name` and `URLTemplate` are required.
5504
5505 `Name` is the name of the search engine.
5506
5507 `URLTemplate` is the search URL with {searchTerms} to substitute for the search term.
5508
5509 `Method` is either GET or POST
5510
5511 `IconURL` is a URL for the icon to use.
5512
5513 `Alias` is a keyword to use for the engine.
5514
5515 `Description` is a description of the search engine.
5516
5517 `PostData` is the POST data as name value pairs separated by &.
5518
5519 `SuggestURLTemplate` is a search suggestions URL with {searchTerms} to substitute for the search term.
5520
5521 `Encoding` is the query charset for the engine. It defaults to UTF-8.
5522
5523 **Compatibility:** Firefox ESR 60 (POST support in Firefox ESR 68, Encoding support in Firefox 91)\
5524 **CCK2 Equivalent:** `searchplugins`\
5525 **Preferences Affected:** N/A
5526
5527 #### Windows (GPO)
5528 ```
5529 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\Name = "Example1"
5530 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\URLTemplate = "https://www.example.org/q={searchTerms}"
5531 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\Method = "GET" | "POST"
5532 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\IconURL = "https://www.example.org/favicon.ico"
5533 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\Alias = "example"
5534 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\Description = "Example Description"
5535 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\SuggestURLTemplate = "https://www.example.org/suggestions/q={searchTerms}"
5536 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\PostData = "name=value&q={searchTerms}"
5537 ```
5538 #### Windows (Intune)
5539 OMA-URI:
5540 ```
5541 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Search/SearchEngines_1
5542 ```
5543 Value (string):
5544 ```
5545 <enabled/>
5546 <data id="SearchEngine_Name" value="Example1"/>
5547 <data id="SearchEngine_URLTemplate" value="https://www.example.org/q={searchTerms"/>
5548 <data id="SearchEngine_Method" value="GET | POST"/>
5549 <data id="SearchEngine_IconURL" value="https://www.example.org/favicon.ico"/>
5550 <data id="SearchEngine_Alias" value="example"/>
5551 <data id="SearchEngine_Description" value="Example Description"/>
5552 <data id="SearchEngine_SuggestURLTemplate" value="https://www.example.org/suggestions/q={searchTerms}"/>
5553 <data id="SearchEngine_PostData" value="name=value&amp;q={searchTerms}"/>
5554 ```
5555 #### macOS
5556 ```
5557 <dict>
5558   <key>SearchEngines</key>
5559   <dict>
5560     <key>Add</key>
5561     <array>
5562       <dict>
5563         <key>Name</key>
5564         <string>Example1</string>
5565         <key>URLTemplate</key>
5566         <string>https://www.example.org/q={searchTerms}</string>
5567         <key>Method</key>
5568         <string>GET | POST </string>
5569         <key>IconURL</key>
5570         <string>https://www.example.org/favicon.ico</string>
5571         <key>Alias</key>
5572         <string>example</string>
5573         <key>Description</key>
5574         <string>Example Description</string>
5575         <key>SuggestURLTemplate</key>
5576         <string>https://www.example.org/suggestions/q={searchTerms}</string>
5577         <key>PostData</key>
5578         <string>name=value&q={searchTerms}</string>
5579       </dict>
5580     <array>
5581   </dict>
5582 </dict>
5583 ```
5584 #### policies.json
5585 ```
5586 {
5587   "policies": {
5588     "SearchEngines": {
5589       "Add": [
5590         {
5591           "Name": "Example1",
5592           "URLTemplate": "https://www.example.org/q={searchTerms}",
5593           "Method": "GET" | "POST",
5594           "IconURL": "https://www.example.org/favicon.ico",
5595           "Alias": "example",
5596           "Description": "Description",
5597           "PostData": "name=value&q={searchTerms}",
5598           "SuggestURLTemplate": "https://www.example.org/suggestions/q={searchTerms}"
5599         }
5600       ]
5601     }
5602   }
5603 }
5604 ```
5605 ### SearchEngines | Default
5606
5607 Set the default search engine. This policy is only available on the ESR.
5608
5609 **Compatibility:** Firefox ESR 60\
5610 **CCK2 Equivalent:** `defaultSearchEngine`\
5611 **Preferences Affected:** N/A
5612
5613 #### Windows (GPO)
5614 ```
5615 Software\Policies\Mozilla\Firefox\SearchEngines\Default = NAME_OF_SEARCH_ENGINE
5616 ```
5617 #### Windows (Intune)
5618 OMA-URI:
5619 ```
5620 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Search/SearchEngines_Default
5621 ```
5622 Value (string):
5623 ```
5624 <enabled/>
5625 <data id="SearchEngines_Default" value="NAME_OF_SEARCH_ENGINE"/>
5626 ```
5627 #### macOS
5628 ```
5629 <dict>
5630   <key>SearchEngines</key>
5631   <dict>
5632     <key>Default</key>
5633     <string>NAME_OF_SEARCH_ENGINE</string>
5634   </dict>
5635 </dict>
5636 ```
5637 #### policies.json
5638 ```
5639 {
5640   "policies": {
5641     "SearchEngines": {
5642       "Default": "NAME_OF_SEARCH_ENGINE"
5643     }
5644   }
5645 }
5646 ```
5647 ### SearchEngines | PreventInstalls
5648
5649 Prevent installing search engines from webpages.
5650
5651 **Compatibility:** Firefox ESR 60\
5652 **CCK2 Equivalent:** `disableSearchEngineInstall`\
5653 **Preferences Affected:** N/A
5654
5655 #### Windows (GPO)
5656 ```
5657 Software\Policies\Mozilla\Firefox\SearchEngines\PreventInstalls = 0x1 | 0x0
5658 ```
5659 #### Windows (Intune)
5660 OMA-URI:
5661 ```
5662 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Search/SearchEngines_PreventInstalls
5663 ```
5664 Value (string):
5665 ```
5666 <enabled/> or <disabled/>
5667 ```
5668 #### macOS
5669 ```
5670 <dict>
5671   <key>SearchEngines</key>
5672   <dict>
5673     <key>PreventInstalls</key>
5674     <true/> | <false/>
5675   </dict>
5676 </dict>
5677 ```
5678 #### policies.json
5679 ```
5680 {
5681   "policies": {
5682     "SearchEngines": {
5683       "PreventInstalls": true | false
5684     }
5685   }
5686 }
5687 ```
5688 ### SearchEngines | Remove
5689
5690 Hide built-in search engines. This policy is only available on the ESR.
5691
5692 **Compatibility:** Firefox ESR 60.2\
5693 **CCK2 Equivalent:** `removeDefaultSearchEngines` (removed all built-in engines)\
5694 **Preferences Affected:** N/A
5695
5696 #### Windows (GPO)
5697 ```
5698 Software\Policies\Mozilla\Firefox\SearchEngines\Remove\1 = NAME_OF_SEARCH_ENGINE
5699 ```
5700 #### Windows (Intune)
5701 OMA-URI:
5702 ```
5703 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Search/SearchEngines_Remove
5704 ```
5705 Value (string):
5706 ```
5707 <enabled/>
5708 <data id="SearchEngines_Remove" value="1&#xF000;NAME_OF_SEARCH_ENGINE"/>
5709 ```
5710 #### macOS
5711 ```
5712 <dict>
5713   <key>SearchEngines</key>
5714   <dict>
5715     <key>Remove</key>
5716     <array>
5717       <string>NAME_OF_SEARCH_ENGINE</string>
5718     </array>
5719   </dict>
5720 </dict>
5721 ```
5722 #### policies.json
5723 ```
5724 {
5725   "policies": {
5726     "SearchEngines": {
5727       "Remove": ["NAME_OF_SEARCH_ENGINE"]
5728     }
5729   }
5730 }
5731 ```
5732 ### SearchSuggestEnabled
5733
5734 Enable search suggestions.
5735
5736 **Compatibility:** Firefox 68, Firefox ESR 68\
5737 **CCK2 Equivalent:** N/A\
5738 **Preferences Affected:** `browser.urlbar.suggest.searches`, `browser.search.suggest.enabled`
5739
5740 #### Windows (GPO)
5741 ```
5742 Software\Policies\Mozilla\Firefox\SearchSuggestEnabled = 0x1 | 0x0
5743 ```
5744 #### Windows (Intune)
5745 OMA-URI:
5746 ```
5747 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Search/SearchSuggestEnabled
5748 ```
5749 Value (string):
5750 ```
5751 <enabled/> or <disabled/>
5752 ```
5753 #### macOS
5754 ```
5755 <dict>
5756   <key>SearchSuggestEnabled</key>
5757   <true/> | <false/>
5758 </dict>
5759 ```
5760 #### policies.json
5761 ```
5762 {
5763   "policies": {
5764     "SearchSuggestEnabled": true | false
5765   }
5766 }
5767 ```
5768 ### SecurityDevices
5769
5770 Add or delete PKCS #11 modules.
5771
5772 **Compatibility:** Firefox 114, Firefox ESR 112.12\
5773 **CCK2 Equivalent:** N/A\
5774 **Preferences Affected:** N/A
5775
5776 #### Windows (GPO)
5777 ```
5778 Software\Policies\Mozilla\Firefox\SecurityDevices\Add\NAME_OF_DEVICE_TO_ADD = PATH_TO_LIBRARY_FOR_DEVICE
5779 Software\Policies\Mozilla\Firefox\SecurityDevices\Remove\1 = NAME_OF_DEVICE_TO_REMOVE
5780 ```
5781 #### Windows (Intune)
5782 OMA-URI:
5783 ```
5784 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/SecurityDevices/SecurityDevices_Add
5785 ```
5786 Value (string):
5787 ```
5788 <enabled/>
5789 <data id="SecurityDevices" value="NAME_OF_DEVICE_TO_ADD&#xF000;PATH_TO_LIBRARY_FOR_DEVICE"/>
5790 ```
5791 OMA-URI:
5792 ```
5793 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/SecurityDevices/SecurityDevices_Delete
5794 ```
5795 Value (string):
5796 ```
5797 <enabled/>
5798 <data id="SecurityDevices" value="1&#xF000;NAME_OF_DEVICE_TO_REMOVE"/>
5799 ```
5800 #### macOS
5801 ```
5802 <dict>
5803   <key>SecurityDevices</key>
5804   <dict>
5805     <key>Add<key>
5806     <dict>
5807       <key>NAME_OF_DEVICE_TO_ADD</key>
5808       <string>PATH_TO_LIBRARY_FOR_DEVICE</string>
5809     </dict>
5810     <key>Delete</add>
5811     <array>
5812       <string>NAME_OF_DEVICE_TO_DELETE</string>
5813     </array>
5814   </dict>
5815 </dict>
5816 ```
5817 #### policies.json
5818 ```
5819 {
5820   "policies": {
5821     "SecurityDevices": {
5822       "Add": {
5823         "NAME_OF_DEVICE_TO_ADD": "PATH_TO_LIBRARY_FOR_DEVICE"
5824       },
5825       "Delete": ["NAME_OF_DEVICE_TO_DELETE"]
5826     }
5827   }
5828 }
5829 ```
5830 ### SecurityDevices (Deprecated)
5831
5832 Install PKCS #11 modules.
5833
5834 **Compatibility:** Firefox 64, Firefox ESR 60.4\
5835 **CCK2 Equivalent:** `certs.devices`\
5836 **Preferences Affected:** N/A
5837
5838 #### Windows (GPO)
5839 ```
5840 Software\Policies\Mozilla\Firefox\SecurityDevices\NAME_OF_DEVICE = PATH_TO_LIBRARY_FOR_DEVICE
5841 ```
5842 #### Windows (Intune)
5843 OMA-URI:
5844 ```
5845 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/SecurityDevices
5846 ```
5847 Value (string):
5848 ```
5849 <enabled/>
5850 <data id="SecurityDevices" value="NAME_OF_DEVICE&#xF000;PATH_TO_LIBRARY_FOR_DEVICE"/>
5851 ```
5852 #### macOS
5853 ```
5854 <dict>
5855   <key>SecurityDevices</key>
5856   <dict>
5857     <key>NAME_OF_DEVICE</key>
5858     <string>PATH_TO_LIBRARY_FOR_DEVICE</string>
5859   </dict>
5860 </dict>
5861 ```
5862 #### policies.json
5863 ```
5864 {
5865   "policies": {
5866     "SecurityDevices": {
5867       "NAME_OF_DEVICE": "PATH_TO_LIBRARY_FOR_DEVICE"
5868     }
5869   }
5870 }
5871 ```
5872 ### ShowHomeButton
5873 Show the home button on the toolbar.
5874
5875 Future versions of Firefox will not show the home button by default.
5876
5877 **Compatibility:** Firefox 88, Firefox ESR 78.10\
5878 **CCK2 Equivalent:** N/A\
5879 **Preferences Affected:** N/A
5880
5881 #### Windows (GPO)
5882 ```
5883 Software\Policies\Mozilla\Firefox\ShowHomeButton = 0x1 | 0x0
5884 ```
5885 #### Windows (Intune)
5886 OMA-URI:
5887 ```
5888 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Homepage/Homepage_ShowHomeButton
5889 ```
5890 Value (string):
5891 ```
5892 <enabled/> or <disabled/>
5893 ```
5894 #### macOS
5895 ```
5896 <dict>
5897   <key>ShowHomeButton</key>
5898   <true/> | <false/>
5899 </dict>
5900 ```
5901 #### policies.json
5902 ```
5903 {
5904   "policies": {
5905     "ShowHomeButton": true | false
5906   }
5907 }
5908 ```
5909 ### SSLVersionMax
5910
5911 Set and lock the maximum version of TLS.
5912
5913 **Compatibility:** Firefox 66, Firefox ESR 60.6\
5914 **CCK2 Equivalent:** N/A\
5915 **Preferences Affected:** `security.tls.version.max`
5916
5917 #### Windows (GPO)
5918 ```
5919 Software\Policies\Mozilla\Firefox\SSLVersionMax = "tls1" | "tls1.1" | "tls1.2" | "tls1.3"
5920 ```
5921 #### Windows (Intune)
5922 OMA-URI:
5923 ```
5924 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/SSLVersionMax
5925 ```
5926 Value (string):
5927 ```
5928 <enabled/>
5929 <data id="SSLVersion" value="tls1 | tls1.2 | tls1.3"/>
5930 ```
5931 #### macOS
5932 ```
5933 <dict>
5934   <key>SSLVersionMax</key>
5935   <string>tls1 | tls1.1 | tls1.2 | tls1.3</string>
5936 </dict>
5937 ```
5938
5939 #### policies.json
5940 ```
5941 {
5942   "policies": {
5943     "SSLVersionMax": "tls1" | "tls1.1" | "tls1.2" | "tls1.3"
5944   }
5945 }
5946 ```
5947 ### SSLVersionMin
5948
5949 Set and lock the minimum version of TLS.
5950
5951 **Compatibility:** Firefox 66, Firefox ESR 60.6\
5952 **CCK2 Equivalent:** N/A\
5953 **Preferences Affected:** `security.tls.version.min`
5954
5955 #### Windows (GPO)
5956 ```
5957 Software\Policies\Mozilla\Firefox\SSLVersionMin = "tls1" | "tls1.1" | "tls1.2" | "tls1.3"
5958 ```
5959 #### Windows (Intune)
5960 OMA-URI:
5961 ```
5962 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/SSLVersionMin
5963 ```
5964 Value (string):
5965 ```
5966 <enabled/>
5967 <data id="SSLVersion" value="tls1 | tls1.2 | tls1.3"/>
5968 ```
5969 #### macOS
5970 ```
5971 <dict>
5972   <key>SSLVersionMin</key>
5973   <string>tls1 | tls1.1 | tls1.2 | tls1.3</string>
5974 </dict>
5975 ```
5976
5977 #### policies.json
5978 ```
5979 {
5980   "policies": {
5981     "SSLVersionMin": "tls1" | "tls1.1" | "tls1.2" | "tls1.3"
5982   }
5983 }
5984 ```
5985 ### SupportMenu
5986 Add a menuitem to the help menu for specifying support information.
5987
5988 **Compatibility:** Firefox 68.0.1, Firefox ESR 68.0.1\
5989 **CCK2 Equivalent:** helpMenu\
5990 **Preferences Affected:** N/A
5991
5992 #### Windows (GPO)
5993 ```
5994 Software\Policies\Mozilla\Firefox\SupportMenu\Title = "Support Menu"
5995 Software\Policies\Mozilla\Firefox\SupportMenu\URL = "http://example.com/support"
5996 Software\Policies\Mozilla\Firefox\SupportMenu\AccessKey = "S"
5997 ```
5998 #### Windows (Intune)
5999 OMA-URI:
6000 ```
6001 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/SupportMenu
6002 ```
6003 Value (string):
6004 ```
6005 <enabled/>
6006 <data id="SupportMenuTitle" value="Support Menu"/>
6007 <data id="SupportMenuURL" value="http://example.com/support"/>
6008 <data id="SupportMenuAccessKey" value="S"/>
6009 ```
6010 #### macOS
6011 ```
6012 <dict>
6013   <key>SupportMenu</key>
6014   <dict>
6015     <key>Title</key>
6016     <string>SupportMenu</string>
6017     <key>URL</key>
6018     <string>http://example.com/support</string>
6019     <key>AccessKey</key>
6020     <string>S</string>
6021   </dict>
6022 </dict>
6023 ```
6024 #### policies.json
6025 ```
6026 {
6027   "policies": {
6028     "SupportMenu": {
6029       "Title": "Support Menu",
6030       "URL": "http://example.com/support",
6031       "AccessKey": "S"
6032     }
6033   }
6034 }
6035 ```
6036 ### StartDownloadsInTempDirectory
6037 Force downloads to start off in a local, temporary location rather than the default download directory.
6038
6039 **Compatibility:** Firefox 102\
6040 **CCK2 Equivalent:** N/A\
6041 **Preferences Affected:** `browser.download.start_downloads_in_tmp_dir`
6042
6043 #### Windows (GPO)
6044 ```
6045 Software\Policies\Mozilla\Firefox\StartDownloadsInTempDirectory = 0x1 | 0x0
6046 ```
6047 #### Windows (Intune)
6048 OMA-URI:
6049 ```
6050 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/StartDownloadsInTempDirectory
6051 ```
6052 Value (string):
6053 ```
6054 <enabled/> or <disabled/>
6055 ```
6056 #### macOS
6057 ```
6058 <dict>
6059   <key>StartDownloadsInTempDirectory</key>
6060   <true/> | <false/>
6061 </dict>
6062 ```
6063 #### policies.json
6064 ```
6065 {
6066   "policies": {
6067     "StartDownloadsInTempDirectory": true | false
6068 }
6069 ```
6070 ### UserMessaging
6071
6072 Prevent Firefox from messaging the user in certain situations.
6073
6074 `WhatsNew` Remove the "What's New" icon and menuitem.
6075
6076 `ExtensionRecommendations` If false, don't recommend extensions while the user is visiting web pages.
6077
6078 `FeatureRecommendations` If false, don't recommend browser features.
6079
6080 `UrlbarInterventions` If false, Don't offer Firefox specific suggestions in the URL bar.
6081
6082 `SkipOnboarding` If true, don't show onboarding messages on the new tab page.
6083
6084 `MoreFromMozilla` If false, don't show the "More from Mozilla" section in Preferences. (Firefox 98)
6085
6086 **Compatibility:** Firefox 75, Firefox ESR 68.7\
6087 **CCK2 Equivalent:** N/A\
6088 **Preferences Affected:** `browser.messaging-system.whatsNewPanel.enabled`, `browser.newtabpage.activity-stream.asrouter.userprefs.cfr.addons`, `browser.newtabpage.activity-stream.asrouter.userprefs.cfr.features`, `browser.aboutwelcome.enabled`, `browser.preferences.moreFromMozilla`
6089
6090 #### Windows (GPO)
6091 ```
6092 Software\Policies\Mozilla\Firefox\UserMessaging\WhatsNew = 0x1 | 0x0
6093 Software\Policies\Mozilla\Firefox\UserMessaging\ExtensionRecommendations = 0x1 | 0x0
6094 Software\Policies\Mozilla\Firefox\UserMessaging\FeatureRecommendations = 0x1 | 0x0
6095 Software\Policies\Mozilla\Firefox\UserMessaging\UrlbarInterventions = 0x1 | 0x0
6096 Software\Policies\Mozilla\Firefox\UserMessaging\SkipOnboarding = 0x1 | 0x0
6097 Software\Policies\Mozilla\Firefox\UserMessaging\MoreFromMozilla = 0x1 | 0x0
6098 ```
6099 #### Windows (Intune)
6100 OMA-URI:
6101 ```
6102 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~UserMessaging/UserMessaging_WhatsNew
6103 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~UserMessaging/UserMessaging_ExtensionRecommendations
6104 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~UserMessaging/UserMessaging_FeatureRecommendations
6105 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~UserMessaging/UserMessaging_UrlbarInterventions
6106 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~UserMessaging/UserMessaging_SkipOnboarding
6107 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~UserMessaging/UserMessaging_MoreFromMozilla
6108 ```
6109 Value (string):
6110 ```
6111 <enabled/> or <disabled/>
6112 ```
6113 #### macOS
6114 ```
6115 <dict>
6116   <key>UserMessaging</key>
6117   <dict>
6118     <key>WhatsNew</key>
6119     <true/> | <false/>
6120     <key>ExtensionRecommendations</key>
6121     <true/> | <false/>
6122     <key>FeatureRecommendations</key>
6123     <true/> | <false/>
6124     <key>UrlbarInterventions</key>
6125     <true/> | <false/>
6126     <key>SkipOnboarding</key>
6127     <true/> | <false/>
6128     <key>MoreFromMozilla</key>
6129     <true/> | <false/>
6130   </dict>
6131 </dict>
6132 ```
6133 #### policies.json
6134 ```
6135 {
6136   "policies": {
6137     "UserMessaging": {
6138       "WhatsNew": true | false,
6139       "ExtensionRecommendations": true | false,
6140       "FeatureRecommendations": true | false,
6141       "UrlbarInterventions": true | false,
6142       "SkipOnboarding": true | false,
6143       "MoreFromMozilla": true | false
6144     }
6145   }
6146 }
6147 ```
6148 ### UseSystemPrintDialog
6149 Use the system print dialog instead of the print preview window.
6150
6151 **Compatibility:** Firefox 102\
6152 **CCK2 Equivalent:** N/A\
6153 **Preferences Affected:** `print.prefer_system_dialog`
6154
6155 #### Windows (GPO)
6156 ```
6157 Software\Policies\Mozilla\Firefox\UseSystemPrintDialog = 0x1 | 0x0
6158 ```
6159 #### Windows (Intune)
6160 OMA-URI:
6161 ```
6162 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/UseSystemPrintDialog
6163 ```
6164 Value (string):
6165 ```
6166 <enabled/> or <disabled/>
6167 ```
6168 #### macOS
6169 ```
6170 <dict>
6171   <key>UseSystemPrintDialog</key>
6172   <true/> | <false/>
6173 </dict>
6174 ```
6175 #### policies.json
6176 ```
6177 {
6178   "policies": {
6179     "UseSystemPrintDialog": true | false
6180   }
6181 }
6182 ```
6183 ### WebsiteFilter
6184 Block websites from being visited. The parameters take an array of Match Patterns, as documented in https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Match_patterns.
6185 The arrays are limited to 1000 entries each.
6186
6187 If you want to block all URLs, you can use `<all_urls>` or `*://*/*`. You can't have just a `*` on the right side.
6188
6189 For specific protocols, use `https://*/*` or `http://*/*`.
6190
6191 As of Firefox 83 and Firefox ESR 78.5, file URLs are supported.
6192
6193 **Compatibility:** Firefox 60, Firefox ESR 60\
6194 **CCK2 Equivalent:** N/A\
6195 **Preferences Affected:** N/A
6196
6197 #### Windows (GPO)
6198 ```
6199 Software\Policies\Mozilla\Firefox\WebsiteFilter\Block\1 = "<all_urls>"
6200 Software\Policies\Mozilla\Firefox\WebsiteFilter\Exceptions\1 = "http://example.org/*"
6201 ```
6202 #### Windows (Intune)
6203 OMA-URI:
6204 ```
6205 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/B_WebsiteFilter_Block
6206 ```
6207 Value (string):
6208 ```
6209 <enabled/> <data id="WebsiteFilter" value="1&#xF000;&#60;all_urls&#62;"/>
6210 ```
6211 OMA-URI:
6212 ```
6213 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/B_WebsiteFilter_Exceptions
6214 ```
6215 Value (string):
6216 ```
6217 <enabled/>
6218 <data id="WebsiteFilter" value="1&#xF000;http://example.org/*"/>
6219 ```
6220 #### macOS
6221 ```
6222 <dict>
6223   <key>WebsiteFilter</key>
6224   <dict>
6225     <key>Block</key>
6226     <array>
6227       <string><all_urls></string>
6228     </array>
6229     <key>Exceptions</key>
6230     <array>
6231       <string>http://example.org/*</string>
6232     </array>
6233   </dict>
6234
6235 </dict>
6236 ```
6237 #### policies.json
6238 ```
6239 {
6240   "policies": {
6241     "WebsiteFilter": {
6242       "Block": ["<all_urls>"],
6243       "Exceptions": ["http://example.org/*"]
6244     }
6245   }
6246 }
6247 ```
6248 ### WindowsSSO
6249 Allow Windows single sign-on for Microsoft, work, and school accounts.
6250
6251 If this policy is set to true, Firefox will use credentials stored in Windows to sign in to Microsoft, work, and school accounts.
6252
6253 **Compatibility:** Firefox 91\
6254 **CCK2 Equivalent:** N/A\
6255 **Preferences Affected:** `network.http.windows-sso.enabled`
6256
6257 #### Windows (GPO)
6258 ```
6259 Software\Policies\Mozilla\Firefox\WindowsSSO = 0x1 | 0x0
6260 ```
6261 #### Windows (Intune)
6262 OMA-URI:
6263 ```
6264 ./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/WindowsSSO
6265 ```
6266 Value (string):
6267 ```
6268 <enabled/> or <disabled/>
6269 ```
6270 #### policies.json
6271 ```
6272 {
6273   "policies": {
6274     "WindowsSSO": true | false
6275   }
6276 }
6277 ```