README.md

   1 **IMPORTANT**: This file is in active development along with the policies in Firefox. Make sure to check the compatibility section to see if a policy is available in a specific version of Firefox. To get the policy information that corresponds to a specific release, go to https://github.com/mozilla/policy-templates/releases.
   2
   3 Policies can be specified using the Group Policy templates on Windows (https://github.com/mozilla/policy-templates/tree/master/windows), 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.
   4
   5 | Policy Name | Description
   6 | --- | --- |
   7 | **[`AppUpdateURL`](#AppUpdateURL)** | Change the URL for application update.
   8 | **[`Authentication`](#Authentication)** | Configure sites that support integrated authentication.
   9 | **[`BlockAboutAddons`](#blockaboutaddons)** | Block access to the Add-ons Manager (about:addons).
  10 | **[`BlockAboutConfig`](#blockaboutconfig)** | Block access to about:config.
  11 | **[`BlockAboutProfiles`](#blockaboutprofiles)** | Block access to About Profiles (about:profiles).
  12 | **[`BlockAboutSupport`](#blockaboutsupport)** | Block access to Troubleshooting Information (about:support).
  13 | **[`Bookmarks`](#bookmarks)** | Add bookmarks in either the bookmarks toolbar or menu.
  14 | **[`CaptivePortal`](#captiveportal)** | Enable or disable the detection of captive portals.
  15 | **[`Certificates`](#certificates)** |
  16 | **[`Certificates -> ImportEnterpriseRoots`](#certificates--importenterpriseroots)** | Trust certificates that have been added to the operating system certificate store by a user or administrator.
  17 | **[`Certificates -> Install`](#certificates--install)** | Install certificates into the Firefox certificate store.
  18 | **[`Cookies`](#cookies)** | Configure cookie preferences.
  19 | **[`DisableSetDesktopBackground`](#disablesetdesktopbackground)** | Remove the "Set As Desktop Background..." menuitem when right clicking on an image.
  20 | **[`DisableMasterPasswordCreation`](#disablemasterpasswordcreation)** | Remove the master password functionality.
  21 | **[`DisableAppUpdate`](#disableappupdate)** | Turn off application updates.
  22 | **[`DisableBuiltinPDFViewer`](#disablebuiltinpdfviewer)** | Disable the built in PDF viewer.
  23 | **[`DisableDeveloperTools`](#disabledevelopertools)** | Remove access to all developer tools.
  24 | **[`DisableFeedbackCommands`](#disablefeedbackcommands)** | Disable the menus for reporting sites.
  25 | **[`DisableFirefoxScreenshots`](#disablefirefoxscreenshots)** | Remove access to Firefox Screenshots.
  26 | **[`DisableFirefoxAccounts`](#disablefirefoxaccounts)** | Disable Firefox Accounts integration (Sync).
  27 | **[`DisableFirefoxStudies`](#disablefirefoxstudies)** | Disable Firefox studies (Shield).
  28 | **[`DisableForgetButton`](#disableforgetbutton)** | Disable the "Forget" button.
  29 | **[`DisableFormHistory`](#disableformhistory)** | Turn off saving information on web forms and the search bar.
  30 | **[`DisablePocket`](#disablepocket)** | Remove Pocket in the Firefox UI.
  31 | **[`DisablePrivateBrowsing`](#disableprivatebrowsing)** | Remove access to private browsing.
  32 | **[`DisableProfileImport`](#disableprofileimport)** | Disables the "Import data from another browser" option in the bookmarks window.
  33 | **[`DisableProfileRefresh`](#disableprofilerefresh)** | Disable the Refresh Firefox button on about:support and support.mozilla.org
  34 | **[`DisableSafeMode`](#disablesafemode)** | Disable safe mode.
  35 | **[`DisableSecurityBypass`](#disablesecuritybypass)** | Prevent the user from bypassing security in certain cases.
  36 | **[`DisableSystemAddonUpdate`](#disablesystemaddonupdate)** | Prevent system add-ons from being installed or update.
  37 | **[`DisableTelemetry`](#disabletelemetry)** | DisableTelemetry
  38 | **[`DisplayBookmarksToolbar`](#displaybookmarkstoolbar)** | Set the initial state of the bookmarks toolbar.
  39 | **[`DisplayMenuBar`](#displaymenubar)** | Set the initial state of the menubar
  40 | **[`DNSOverHTTPS`](#dnsoverhttps)** | Configure DNS over HTTPS.
  41 | **[`DontCheckDefaultBrowser`](#dontcheckdefaultbrowser)** | Don't check if Firefox is the default browser at startup.
  42 | **[`EnableTrackingProtection`](#enabletrackingprotection)** | Configure tracking protection.
  43 | **[`Extensions`](#extensions)** | Control the installation, uninstallation and locking of extensions.
  44 | **[`ExtensionUpdate`](#extensionupdate)** | Control extension updates.
  45 | **[`FlashPlugin`](#flashplugin)** | Configure the default Flash plugin policy as well as origins for which Flash is allowed.
  46 | **[`HardwareAcceleration`](#hardwareacceleration)** | Control hardware acceleration.
  47 | **[`Homepage`](#homepage)** | Configure the default homepage and how Firefox starts.
  48 | **[`InstallAddonsPermission`](#installaddonspermission)** | Configure the default extension install policy as well as origins for extension installs are allowed.
  49 | **[`NetworkPrediction`](#networkprediction)** | Enable or disable network prediction (DNS prefetching).
  50 | **[`NoDefaultBookmarks`](#nodefaultbookmarks)** | Disable the creation of default bookmarks.
  51 | **[`OfferToSaveLogins`](#offertosavelogins)** | Control whether or not Firefox offers to save passwords.
  52 | **[`OverrideFirstRunPage`](#overridefirstrunpage)** | Override the first run page.
  53 | **[`OverridePostUpdatePage`](#overridepostupdatepage)** | Override the upgrade page.
  54 | **[`PopupBlocking`](#popupblocking)** | Configure the default pop-up window policy as well as origins for which pop-up windows are allowed.
  55 | **[`Permissions`](#permissions)** | Set permissions associated with camera, microphone, location, and notifications.
  56 | **[`Preferences`](#preferences)** | Set and lock some preferences.
  57 | **[`Proxy`](#proxy)** | Configure proxy settings.
  58 | **[`RequestedLocales`](#requestedlocales)** | Set the the list of requested locales for the application in order of preference.
  59 | **[`SanitizeOnShutdown`](#sanitizeonshutdown)** | Clear all data on shutdown.
  60 | **[`SearchBar`](#searchbar)** | Set whether or not search bar is displayed.
  61 | **[`SearchEngines`](#searchengines-this-policy-is-only-available-on-the-esr)** |
  62 | **[`SearchEngines -> Default`](#searchengines--default)** | Set the default search engine.
  63 | **[`SearchEngines -> PreventInstalls`](#searchengines--preventinstalls)** | Prevent installing search engines from webpages.
  64 | **[`SearchEngines -> Remove`](#searchengines--remove)** | Hide built-in search engines.
  65 | **[`SearchEngines -> Add`](#searchengines--add)** | Add new search engines.
  66 | **[`SecurityDevices`](#securitydevices)** | Install PKCS #11 modules.
  67 | **[`SSLVersionMax`](#sslversionmax)** | Set and lock the maximum version of TLS.
  68 | **[`SSLVersionMin`](#sslversionmin)** | Set and lock the minimum version of TLS.
  69 | **[`WebsiteFilter`](#websitefilter)** | Block websites from being visited.
  70
  71
  72 ### AppUpdateURL
  73
  74 Change the URL for application update.
  75
  76 **Compatibility:** Firefox 62, Firefox ESR 60.2\
  77 **CCK2 Equivalent:** N/A\
  78 **Preferences Affected:** `app.update.url`
  79
  80 #### Windows
  81 ```
  82 Software\Policies\Mozilla\Firefox\AppUpdateURL = "https://yoursite.com"
  83 ```
  84 #### macOS
  85 ```
  86 <dict>
  87   <key>AppUpdateURL</key>
  88   <string>https://yoursite.com</string>
  89 </dict>
  90 ```
  91 ### JSON
  92 ```
  93 {
  94   "policies": {
  95     "AppUpdateURL": "https://yoursite.com"
  96   }
  97 }
  98 ```
  99 ### Authentication
 100
 101 Configure sites that support integrated authentication.
 102
 103 See https://developer.mozilla.org/en-US/docs/Mozilla/Integrated_authentication for more information.
 104
 105 **Compatibility:** Firefox 60, Firefox ESR 60 (AllowNonFQDN added in 62/60.2)\
 106 **CCK2 Equivalent:** N/A\
 107 **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`
 108
 109 #### Windows
 110 ```
 111 Software\Policies\Mozilla\Firefox\Authentication\SPNEGO\1 = "mydomain.com"
 112 Software\Policies\Mozilla\Firefox\Authentication\SPNEGO\2 = "https://myotherdomain.com"
 113 Software\Policies\Mozilla\Firefox\Authentication\Delegated\1 = "mydomain.com"
 114 Software\Policies\Mozilla\Firefox\Authentication\Delegated\2 = "https://myotherdomain.com"
 115 Software\Policies\Mozilla\Firefox\Authentication\NTLM\1 = "mydomain.com"
 116 Software\Policies\Mozilla\Firefox\Authentication\NTLM\2 = "https://myotherdomain.com"
 117 Software\Policies\Mozilla\Firefox\Authentication\AllowNonFQDN\SPNEGO = 0x1 | 0x0
 118 Software\Policies\Mozilla\Firefox\Authentication\AllowNonFQDN\NTLM = 0x1 | 0x0
 119 ```
 120 #### macOS
 121 ```
 122 <dict>
 123   <key>Authentication</key>
 124   <dict>
 125     <key>SPNEGO</key>
 126     <array>
 127       <string>mydomain.com</string>
 128       <string>https://myotherdomain.com</string>
 129     </array>
 130     <key>Delegated</key>
 131     <array>
 132       <string>mydomain.com</string>
 133       <string>https://myotherdomain.com</string>
 134     </array>
 135     <key>NTLM</key>
 136     <array>
 137       <string>mydomain.com</string>
 138       <string>https://myotherdomain.com</string>
 139     </array>
 140     <key>AllowNonFQDN</key>
 141       <dict>
 142       <key>SPNEGO</key>
 143       <true/> | <false/>
 144       <key>NTLM</key>
 145       <true/> | <false/>
 146     </dict>
 147   </dict>
 148 </dict>
 149 ```
 150 ### JSON
 151 ```
 152 {
 153   "policies": {
 154     "Authentication": {
 155       "SPNEGO": ["mydomain.com", "https://myotherdomain.com"],
 156       "Delegated": ["mydomain.com", "https://myotherdomain.com"],
 157       "NTLM": ["mydomain.com", "https://myotherdomain.com"],
 158       "AllowNonFQDN": {
 159         "SPNEGO": true | false,
 160         "NTLM": true | false
 161       }
 162     }
 163   }
 164 }
 165 ```
 166 ### BlockAboutAddons
 167
 168 Block access to the Add-ons Manager (about:addons).
 169
 170 **Compatibility:** Firefox 60, Firefox ESR 60\
 171 **CCK2 Equivalent:** `disableAddonsManager`\
 172 **Preferences Affected:** N/A
 173
 174 #### Windows
 175 ```
 176 Software\Policies\Mozilla\Firefox\BlockAboutAddons = 0x1 | 0x0
 177 ```
 178 #### macOS
 179 ```
 180 <dict>
 181   <key>BlockAboutAddons</key>
 182   <true/> | <false/>
 183 </dict>
 184 ```
 185 #### JSON
 186 ```
 187 {
 188   "policies": {
 189     "BlockAboutAddons": true | false
 190   }
 191 }
 192 ```
 193 ### BlockAboutConfig
 194
 195 Block access to about:config.
 196
 197 **Compatibility:** Firefox 60, Firefox ESR 60\
 198 **CCK2 Equivalent:** `disableAboutConfig`\
 199 **Preferences Affected:** N/A
 200
 201 #### Windows
 202 ```
 203 Software\Policies\Mozilla\Firefox\BlockAboutConfig = 0x1 | 0x0
 204 ```
 205 #### macOS
 206 ```
 207 <dict>
 208   <key>BlockAboutConfig</key>
 209   <true/> | <false/>
 210 </dict>
 211 ```
 212 #### JSON
 213 ```
 214 {
 215   "policies": {
 216     "BlockAboutConfig": true | false
 217   }
 218 }
 219 ```
 220 ### BlockAboutProfiles
 221
 222 Block access to About Profiles (about:profiles).
 223
 224 **Compatibility:** Firefox 60, Firefox ESR 60\
 225 **CCK2 Equivalent:** `disableAboutProfiles`\
 226 **Preferences Affected:** N/A
 227
 228 #### Windows
 229 ```
 230 Software\Policies\Mozilla\Firefox\BlockAboutProfiles = 0x1 | 0x0
 231 ```
 232 #### macOS
 233 ```
 234 <dict>
 235   <key>BlockAboutProfiles</key>
 236   <true/> | <false/>
 237 </dict>
 238 ```
 239 #### JSON
 240 ```
 241 {
 242   "policies": {
 243     "BlockAboutProfiles": true | false
 244   }
 245 }
 246 ```
 247 ### BlockAboutSupport
 248
 249 Block access to Troubleshooting Information (about:support).
 250
 251 **Compatibility:** Firefox 60, Firefox ESR 60\
 252 **CCK2 Equivalent:** `disableAboutSupport`\
 253 **Preferences Affected:** N/A
 254
 255 #### Windows
 256 ```
 257 Software\Policies\Mozilla\Firefox\BlockAboutSupport = 0x1 | 0x0
 258 ```
 259 #### macOS
 260 ```
 261 <dict>
 262   <key>BlockAboutSupport</key>
 263   <true/> | <false/>
 264 </dict>
 265 ```
 266 #### JSON
 267 ```
 268 {
 269   "policies": {
 270     "BlockAboutSupport": true | false
 271   }
 272 }
 273 ```
 274 ### Bookmarks
 275
 276 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.
 277
 278 **Compatibility:** Firefox 60, Firefox ESR 60\
 279 **CCK2 Equivalent:** `bookmarks.toolbar`,`bookmarks.menu`\
 280 **Preferences Affected:** N/A
 281
 282 #### Windows
 283 ```
 284 Software\Policies\Mozilla\Firefox\Bookmarks\1\Title = "Example"
 285 Software\Policies\Mozilla\Firefox\Bookmarks\1\URL = "https://example.com"
 286 Software\Policies\Mozilla\Firefox\Bookmarks\1\Favicon = "https://example.com/favicon.ico"
 287 Software\Policies\Mozilla\Firefox\Bookmarks\1\Placement = "toolbar" | "menu"
 288 Software\Policies\Mozilla\Firefox\Bookmarks\1\Folder = "FolderName"
 289 ```
 290 #### macOS
 291 ```
 292 <dict>
 293   <key>Bookmarks</key>
 294   <array>
 295     <dict>
 296       <key>Title</key>
 297       <string>Example</string>
 298       <key>URL</key>
 299       <string>https://example.com</string>
 300       <key>Favicon</key>
 301       <string>https://example.com/favicon.ico</string>
 302       <key>Placement</key>
 303       <string>toolbar | menu</string>
 304       <key>Folder</key>
 305       <string>FolderName</string>
 306     </dict>
 307   </array>
 308 </dict>
 309 ```
 310 ### JSON
 311 ```
 312 {
 313   "policies": {
 314     "Bookmarks": [
 315       {
 316         "Title": "Example",
 317         "URL": "https://example.com",
 318         "Favicon": "https://example.com/favicon.ico",
 319         "Placement": "toolbar" | "menu",
 320         "Folder": "FolderName"
 321       }
 322     ]
 323   }
 324 }
 325 ```
 326 ### CaptivePortal
 327 Enable or disable the detection of captive portals.
 328
 329 **Compatibility:** Firefox 67, Firefox ESR 60.7\
 330 **CCK2 Equivalent:** N/A\
 331 **Preferences Affected:** `network.captive-portal-service.enabled`
 332
 333 #### Windows
 334 ```
 335 Software\Policies\Mozilla\Firefox\CaptivePortal = 0x1 | 0x0
 336 ```
 337 #### macOS
 338 ```
 339 <dict>
 340   <key>CaptivePortal</key>
 341   <true/> | <false/>
 342 </dict>
 343 ```
 344 #### JSON
 345 ```
 346 {
 347   "policies": {
 348     "CaptivePortal": true | false
 349   }
 350 }
 351 ```
 352 ### Certificates
 353
 354 ### Certificates | ImportEnterpriseRoots
 355
 356 Trust certificates that have been added to the operating system certificate store by a user or administrator.
 357
 358 See https://support.mozilla.org/kb/setting-certificate-authorities-firefox for more detail.
 359
 360 **Compatibility:** Firefox 60, Firefox ESR 60 (macOS support in Firefox 63, Firefox ESR 68)\
 361 **CCK2 Equivalent:** N/A\
 362 **Preferences Affected:** `security.enterprise_roots.enabled`
 363
 364 #### Windows
 365 ```
 366 Software\Policies\Mozilla\Firefox\Certificates\ImportEnterpriseRoots = 0x1 | 0x0
 367 ```
 368 #### macOS
 369 ```
 370 <dict>
 371   <key>Certificates</key>
 372   <dict>
 373     <key>ImportEnterpriseRoots</key>
 374     <true/> | <false/>
 375   </dict>
 376 </dict>
 377 ```
 378 #### JSON
 379 ```
 380 {
 381   "policies": {
 382     "Certificates": {
 383       "ImportEnterpriseRoots": true | false
 384     }
 385   }
 386 }
 387 ```
 388 ### Certificates | Install
 389
 390 Install certificates into the Firefox certificate store. If only a filename is specified, Firefox searches for the file in the following locations:
 391
 392 - Windows
 393   - %USERPROFILE%\AppData\Local\Mozilla\Certificates
 394   - %USERPROFILE%\AppData\Roaming\Mozilla\Certificates
 395 - macOS
 396   - /Library/Application Support/Mozilla/Certificates
 397   - ~/Library/Application Support/Mozilla/Certificates
 398 - Linux
 399   - /usr/lib/mozilla/certificates
 400   - /usr/lib64/mozilla/certificates
 401   - ~/.mozilla/certificates
 402
 403 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.
 404
 405 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.
 406
 407 Certificates are installed using the trust string `CT,CT,`.
 408
 409 Binary (DER) and ASCII (PEM) certificates are both supported.
 410
 411 **Compatibility:** Firefox 64, Firefox ESR 64\
 412 **CCK2 Equivalent:** `certs.ca`\
 413 **Preferences Affected:** N/A
 414
 415 #### Windows
 416 ```
 417 Software\Policies\Mozilla\Firefox\Certificates\Install\1 = "cert1.der"
 418 Software\Policies\Mozilla\Firefox\Certificates\Install\2 = "C:\Users\username\cert2.pem"
 419 ```
 420 #### macOS
 421 ```
 422 <dict>
 423   <key>Certificates</key>
 424   <dict>
 425     <key>Install</key>
 426     <array>
 427       <string>cert1.der</string>
 428       <string>/Users/username/cert2.pem</string>
 429     </array>
 430   </dict>
 431 </dict>
 432 ```
 433 #### JSON
 434 ```
 435 {
 436   "policies": {
 437     "Certificates": {
 438       "Install": ["cert1.der", "/home/username/cert2.pem"]
 439     }
 440   }
 441 }
 442 ```
 443 ### Cookies
 444 Configure cookie preferences.
 445
 446 `Allow` is a list of origins (not domains) where cookies are always allowed. You must include http or https.
 447
 448 `Block` is a list of origins (not domains) where cookies are always blocked. You must include http or https.
 449
 450 `Default` determines whether cookies are accepted at all.
 451
 452 `AcceptThirdParty` determines how third-party cookies are handled.
 453
 454 `ExpireAtSessionEnd` determines when cookies expire.
 455
 456 `RejectTracker` only rejects cookies for trackers.
 457
 458 `Locked` prevents the user from changing cookie preferences.
 459
 460 **Compatibility:** Firefox 60, Firefox ESR 60 (RejectTracker was added in Firefox 63)\
 461 **CCK2 Equivalent:** N/A\
 462 **Preferences Affected:** `network.cookie.cookieBehavior`,`network.cookie.lifetimePolicy`
 463
 464 #### Windows
 465 ```
 466 Software\Policies\Mozilla\Firefox\Cookies\Allow\1 = "https://example.com"
 467 Software\Policies\Mozilla\Firefox\Cookies\Block\1 = "https://example.org"
 468 Software\Policies\Mozilla\Firefox\Cookies\Default = 0x1 | 0x0
 469 Software\Policies\Mozilla\Firefox\Cookies\AcceptThirdParty = "always" | "never" |"from-visited"
 470 Software\Policies\Mozilla\Firefox\Cookies\ExpireAtSessionEnd = 0x1 | 0x0
 471 Software\Policies\Mozilla\Firefox\Cookies\RejectTracker = 0x1 | 0x0
 472 Software\Policies\Mozilla\Firefox\Cookies\Locked = 0x1 | 0x0
 473 ```
 474 #### macOS
 475 ```
 476 <dict>
 477   <key>Cookies</key>
 478   <dict>
 479     <key>Allow</key>
 480     <array>
 481       <string>http://example.com</string>
 482     </array>
 483     <key>Block</key>
 484     <array>
 485       <string>http://example.org</string>
 486     </array>
 487     <key>Default</key>
 488     <true/> | <false/>
 489     <key>AcceptThirdParty</key>
 490     <string>always | never | from-visited</string>
 491     <key>ExpireAtSessionEnd</key>
 492     <true/> | <false/>
 493     <key>RejectTracker</key>
 494     <true/> | <false/>
 495     <key>Locked</key>
 496     <true/> | <false/>
 497   </dict>
 498 </dict>
 499 ```
 500 #### JSON
 501 ```
 502 {
 503   "policies": {
 504     "Cookies": {
 505       "Allow": ["http://example.org/"],
 506       "Block": ["http://example.edu/"],
 507       "Default": true | false,
 508       "AcceptThirdParty": "always" | "never" | "from-visited"],
 509       "ExpireAtSessionEnd": true | false,
 510       "RejectTracker": true | false,
 511       "Locked": true | false
 512     }
 513   }
 514 }
 515 ```
 516 ### DisableSetDesktopBackground
 517 Remove the "Set As Desktop Background..." menuitem when right clicking on an image.
 518
 519 **Compatibility:** Firefox 60, Firefox ESR 60\
 520 **CCK2 Equivalent:** `removeSetDesktopBackground`\
 521 **Preferences Affected:** N/A
 522
 523 #### Windows
 524 ```
 525 Software\Policies\Mozilla\Firefox\DisableSetDesktopBackground = 0x1 | 0x0
 526 ```
 527
 528 #### macOS
 529 ```
 530 <dict>
 531   <key>DisableSetDesktopBackground</key>
 532   <true/> | <false/>
 533 </dict>
 534 ```
 535 #### JSON
 536 ```
 537 {
 538   "policies": {
 539     "DisableSetDesktopBackground": true | false
 540   }
 541 }
 542 ```
 543 ### DisableMasterPasswordCreation
 544 Remove the master password functionality.
 545
 546 **Compatibility:** Firefox 60, Firefox ESR 60\
 547 **CCK2 Equivalent:** `noMasterPassword`\
 548 **Preferences Affected:** N/A
 549
 550 #### Windows
 551 ```
 552 Software\Policies\Mozilla\Firefox\DisableMasterPasswordCreation = 0x1 | 0x0
 553 ```
 554
 555 #### macOS
 556 ```
 557 <dict>
 558   <key>DisableMasterPasswordCreation</key>
 559   <true/> | <false/>
 560 </dict>
 561 ```
 562 #### JSON
 563 ```
 564 {
 565   "policies": {
 566     "DisableMasterPasswordCreation": true | false
 567   }
 568 }
 569 ```
 570 ### DisableAppUpdate
 571 Turn off application updates.
 572
 573 **Compatibility:** Firefox 60, Firefox ESR 60\
 574 **CCK2 Equivalent:** `disableFirefoxUpdates`\
 575 **Preferences Affected:** N/A
 576
 577 #### Windows
 578 ```
 579 Software\Policies\Mozilla\Firefox\DisableAppUpdate = 0x1 | 0x0
 580 ```
 581 #### macOS
 582 ```
 583 <dict>
 584   <key>DisableAppUpdate</key>
 585   <true/> | <false/>
 586 </dict>
 587 ```
 588 #### JSON
 589 ```
 590 {
 591   "policies": {
 592     "DisableAppUpdate": true | false
 593   }
 594 }
 595 ```
 596 ### DisableBuiltinPDFViewer
 597 Disable the built in PDF viewer. PDF files are downloaded and sent externally.
 598
 599 **Compatibility:** Firefox 60, Firefox ESR 60\
 600 **CCK2 Equivalent:** `disablePDFjs`\
 601 **Preferences Affected:** `pdfjs.disabled`
 602
 603 #### Windows
 604 ```
 605 Software\Policies\Mozilla\Firefox\DisableBuiltinPDFViewer = 0x1 | 0x0
 606 ```
 607
 608 #### macOS
 609 ```
 610 <dict>
 611   <key>DisableBuiltinPDFViewer</key>
 612   <true/> | <false/>
 613 </dict>
 614 ```
 615 #### JSON
 616 ```
 617 {
 618   "policies": {
 619     "DisableBuiltinPDFViewer": true | false
 620   }
 621 }
 622 ```
 623 ### DisableDeveloperTools
 624 Remove access to all developer tools.
 625
 626 **Compatibility:** Firefox 60, Firefox ESR 60\
 627 **CCK2 Equivalent:** `removeDeveloperTools`\
 628 **Preferences Affected:** `devtools.policy.disabled`
 629
 630 #### Windows
 631 ```
 632 Software\Policies\Mozilla\Firefox\DisableDeveloperTools = 0x1 | 0x0`
 633 ```
 634
 635 #### macOS
 636 ```
 637 <dict>
 638   <key>DisableDeveloperTools</key>
 639   <true/> | <false/>
 640 </dict>
 641 ```
 642 #### JSON
 643 ```
 644 {
 645   "policies": {
 646     "DisableDeveloperTools": true | false
 647   }
 648 }
 649 ```
 650 ### DisableFeedbackCommands
 651 Disable the menus for reporting sites (Submit Feedback, Report Deceptive Site).
 652
 653 **Compatibility:** Firefox 60, Firefox ESR 60\
 654 **CCK2 Equivalent:** N/A\
 655 **Preferences Affected:** N/A
 656
 657 #### Windows
 658 ```
 659 Software\Policies\Mozilla\Firefox\DisableFeedbackCommands = 0x1 | 0x0
 660 ```
 661 #### macOS
 662 ```
 663 <dict>
 664   <key>DisableFeedbackCommands</key>
 665   <true/> | <false/>
 666 </dict>
 667 ```
 668 #### JSON
 669 ```
 670 {
 671   "policies": {
 672     "DisableFeedbackCommands": true | false
 673   }
 674 }
 675 ```
 676 ### DisableFirefoxScreenshots
 677 Remove access to Firefox Screenshots.
 678
 679 **Compatibility:** Firefox 60, Firefox ESR 60\
 680 **CCK2 Equivalent:** N/A\
 681 **Preferences Affected:** `extensions.screenshots.disabled`
 682
 683 #### Windows
 684 ```
 685 Software\Policies\Mozilla\Firefox\DisableFirefoxScreenshots = 0x1 | 0x0
 686 ```
 687 #### macOS
 688 ```
 689 <dict>
 690   <key>DisableFirefoxScreenshots</key>
 691   <true/> | <false/>
 692 </dict>
 693 ```
 694 #### JSON
 695 ```
 696 {
 697   "policies": {
 698     "DisableFirefoxScreenshots": true | false
 699   }
 700 }
 701 ```
 702 ### DisableFirefoxAccounts
 703 Disable Firefox Accounts integration (Sync).
 704
 705 **Compatibility:** Firefox 60, Firefox ESR 60\
 706 **CCK2 Equivalent:** `disableSync`\
 707 **Preferences Affected:** `identity.fxaccounts.enabled`
 708
 709 #### Windows
 710 ```
 711 Software\Policies\Mozilla\Firefox\DisableFirefoxAccounts = 0x1 | 0x0
 712 ```
 713 #### macOS
 714 ```
 715 <dict>
 716   <key>DisableFirefoxAccounts</key>
 717   <true/> | <false/>
 718 </dict>
 719 ```
 720 #### JSON
 721 ```
 722 {
 723   "policies": {
 724     "DisableFirefoxAccounts": true | false
 725   }
 726 }
 727 ```
 728 ### DisableFirefoxStudies
 729 Disable Firefox studies (Shield).
 730
 731 **Compatibility:** Firefox 60, Firefox ESR 60\
 732 **CCK2 Equivalent:** `disableForget`\
 733 **Preferences Affected:** N/A
 734
 735 #### Windows
 736 ```
 737 Software\Policies\Mozilla\Firefox\DisableFirefoxStudies = 0x1 | 0x0
 738 ```
 739 #### macOS
 740 ```
 741 <dict>
 742   <key>DisableFirefoxStudies</key>
 743   <true/> | <false/>
 744 </dict>
 745 ```
 746 #### JSON
 747 ```
 748 {
 749   "policies": {
 750     "DisableFirefoxStudies": true | false
 751   }
 752 }
 753 ```
 754 ### DisableForgetButton
 755 Disable the "Forget" button.
 756
 757 **Compatibility:** Firefox 60, Firefox ESR 60\
 758 **CCK2 Equivalent:** `disableForget`\
 759 **Preferences Affected:** N/A
 760
 761 #### Windows
 762 ```
 763 Software\Policies\Mozilla\Firefox\DisableForgetButton = 0x1 | 0x0
 764 ```
 765 #### macOS
 766 ```
 767 <dict>
 768   <key>DisableForgetButton</key>
 769   <true/> | <false/>
 770 </dict>
 771 ```
 772 #### JSON
 773 ```
 774 {
 775   "policies": {
 776     "DisableForgetButton": true | false
 777   }
 778 }
 779 ```
 780 ### DisableFormHistory
 781 Turn off saving information on web forms and the search bar.
 782
 783 **Compatibility:** Firefox 60, Firefox ESR 60\
 784 **CCK2 Equivalent:** `disableFormFill`\
 785 **Preferences Affected:** ` browser.formfill.enable`
 786
 787 #### Windows
 788 ```
 789 Software\Policies\Mozilla\Firefox\DisableFormHistory = 0x1 | 0x0
 790 ```
 791 #### macOS
 792 ```
 793 <dict>
 794   <key>DisableFormHistory</key>
 795   <true/> | <false/>
 796 </dict>
 797 ```
 798 #### JSON
 799 ```
 800 {
 801   "policies": {
 802     "DisableFormHistory": true | false
 803   }
 804 }
 805 ```
 806 ### DisablePocket
 807 Remove Pocket in the Firefox UI. It does not remove it from the new tab page.
 808
 809 **Compatibility:** Firefox 60, Firefox ESR 60\
 810 **CCK2 Equivalent:** `disablePocket`\
 811 **Preferences Affected:** `extensions.pocket.enabled`
 812
 813 #### Windows
 814 ```
 815 Software\Policies\Mozilla\Firefox\DisablePocket = 0x1 | 0x0
 816 ```
 817 #### macOS
 818 ```
 819 <dict>
 820   <key>DisablePocket</key>
 821   <true/> | <false/>
 822 </dict>
 823 ```
 824 #### JSON
 825 ```
 826 {
 827   "policies": {
 828     "DisablePocket": true | false
 829   }
 830 }
 831 ```
 832 ### DisablePrivateBrowsing
 833 Remove access to private browsing.
 834
 835 **Compatibility:** Firefox 60, Firefox ESR 60\
 836 **CCK2 Equivalent:** `disablePrivateBrowsing`\
 837 **Preferences Affected:** N/A
 838
 839 #### Windows
 840 ```
 841 Software\Policies\Mozilla\Firefox\DisablePrivateBrowsing = 0x1 | 0x0
 842 ```
 843 #### macOS
 844 ```
 845 <dict>
 846   <key>DisablePrivateBrowsing</key>
 847   <true/> | <false/>
 848 </dict>
 849 ```
 850 #### JSON
 851 ```
 852 {
 853   "policies": {
 854     "DisablePrivateBrowsing": true | false
 855   }
 856 }
 857 ```
 858 ### DisableProfileImport
 859 Disables the "Import data from another browser" option in the bookmarks window.
 860
 861 **Compatibility:** Firefox 60, Firefox ESR 60\
 862 **CCK2 Equivalent:** N/A\
 863 **Preferences Affected:** N/A
 864
 865 #### Windows
 866 ```
 867 Software\Policies\Mozilla\Firefox\DisableProfileImport = 0x1 | 0x0
 868 ```
 869 #### macOS
 870 ```
 871 <dict>
 872   <key>DisableProfileImport</key>
 873   <true/> | <false/>
 874 </dict>
 875 ```
 876 #### JSON
 877 ```
 878 {
 879   "policies": {
 880     "DisableProfileImport": true | false
 881   }
 882 }
 883 ```
 884 ### DisableProfileRefresh
 885 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.
 886
 887 **Compatibility:** Firefox 60, Firefox ESR 60\
 888 **CCK2 Equivalent:** `disableResetFirefox`\
 889 **Preferences Affected:** `browser.disableResetPrompt`
 890
 891 #### Windows
 892 ```
 893 Software\Policies\Mozilla\Firefox\DisableProfileRefresh = 0x1 | 0x0
 894 ```
 895 #### macOS
 896 ```
 897 <dict>
 898   <key>DisableProfileRefresh</key>
 899   <true/> | <false/>
 900 </dict>
 901 ```
 902 #### JSON
 903 ```
 904 {
 905   "policies": {
 906     "DisableProfileRefresh": true | false
 907   }
 908 }
 909 ```
 910 ### DisableSafeMode
 911 Disable safe mode.
 912
 913 **Compatibility:** Firefox 60, Firefox ESR 60 (Windows, macOS)\
 914 **CCK2 Equivalent:** `disableSafeMode`\
 915 **Preferences Affected:** N/A
 916
 917 #### Windows
 918 ```
 919 Software\Policies\Mozilla\Firefox\DisableSafeMode = 0x1 | 0x0
 920 ```
 921 #### macOS
 922 ```
 923 <dict>
 924   <key>DisableSafeMode</key>
 925   <true/> | <false/>
 926 </dict>
 927 ```
 928 #### JSON
 929 ```
 930 {
 931   "policies": {
 932     "DisableSafeMode": true | false
 933   }
 934 }
 935 ```
 936 ### DisableSecurityBypass
 937 Prevent the user from bypassing security in certain cases.
 938
 939 `InvalidCertificate` prevents adding an exception when an invalid certificate is shown.
 940
 941 `SafeBrowsing` prevents selecting "ignore the risk" and visiting a harmful site anyway.
 942
 943 **Compatibility:** Firefox 60, Firefox ESR 60\
 944 **CCK2 Equivalent:** N/A\
 945 **Preferences Affected:** `security.certerror.hideAddException`,`browser.safebrowsing.allowOverride`
 946
 947 #### Windows
 948 ```
 949 Software\Policies\Mozilla\Firefox\DisableSecurityBypass\InvalidCertificate = 0x1 | 0x0
 950 Software\Policies\Mozilla\Firefox\DisableSecurityBypass\SafeBrowsing = 0x1 | 0x0
 951 ```
 952 #### macOS
 953 ```
 954 <dict>
 955   <key>DisableSecurityBypass</key>
 956   <dict>
 957     <key>InvalidCertificate</key>
 958     <true/> | <false/>
 959     <key><SafeBrowsing/key>
 960     <true/> | <false/>
 961   </dict>
 962 </dict>
 963 ```
 964 #### JSON
 965 ```
 966 {
 967   "policies": {
 968     "DisableSecurityBypass": {
 969       "InvalidCertificate": true false,
 970       "SafeBrowsing": true false
 971     }
 972   }
 973 }
 974 ```
 975 ### DisableSystemAddonUpdate
 976 Prevent system add-ons from being installed or update.
 977
 978 **Compatibility:** Firefox 60, Firefox ESR 60\
 979 **CCK2 Equivalent:** N/A\
 980 **Preferences Affected:** N/A
 981
 982 #### Windows
 983 ```Software\Policies\Mozilla\Firefox\DisableSystemAddonUpdate = 0x1 | 0x0
 984 ```
 985 #### macOS
 986 ```
 987 <dict>
 988   <key>DisableSystemAddonUpdate</key>
 989   <true/> | <false/>
 990 </dict>
 991 ```
 992 #### JSON
 993 ```
 994 {
 995   "policies": {
 996     "DisableSystemAddonUpdate": true | false
 997   }
 998 }
 999 ```
1000 ### DisableTelemetry
1001 Prevent the upload of telemetry data.
1002
1003 Mozilla recommends that you do not disable telemetry. Information collected through telemetry helps us build a better product for businesses like yours.
1004
1005 **Compatibility:** Firefox 60, Firefox ESR 60\
1006 **CCK2 Equivalent:** `disableTelemetry`\
1007 **Preferences Affected:** `datareporting.healthreport.uploadEnabled,datareporting.policy.dataSubmissionEnabled`
1008
1009 #### Windows
1010 ```
1011 Software\Policies\Mozilla\Firefox\DisableTelemetry = 0x1 | 0x0
1012 ```
1013 #### macOS
1014 ```
1015 <dict>
1016   <key>DisableTelemetry</key>
1017   <true/> | <false/>
1018 </dict>
1019 ```
1020 #### JSON
1021 ```
1022 {
1023   "policies": {
1024     "DisableTelemetry": true | false
1025   }
1026 }
1027 ```
1028 ### DisplayBookmarksToolbar
1029 Set the initial state of the bookmarks toolbar. A user can still hide it and it will stay hidden.
1030
1031 **Compatibility:** Firefox 60, Firefox ESR 60\
1032 **CCK2 Equivalent:** `displayBookmarksToolbar`\
1033 **Preferences Affected:** N/A
1034
1035 #### Windows
1036 ```
1037 Software\Policies\Mozilla\Firefox\DisplayBookmarksToolbar = 0x1 | 0x0
1038 ```
1039 #### macOS
1040 ```
1041 <dict>
1042   <key>DisplayBookmarksToolbar</key>
1043   <true/> | <false/>
1044 </dict>
1045 ```
1046 #### JSON
1047 ```
1048 {
1049   "policies": {
1050     "DisplayBookmarksToolbar": true | false
1051   }
1052 }
1053 ```
1054 ### DisplayMenuBar
1055 Set the initial state of the menubar. A user can still hide it and it will stay hidden.
1056
1057 **Compatibility:** Firefox 60, Firefox ESR 60 (Windows, some Linux)\
1058 **CCK2 Equivalent:** `displayMenuBar`\
1059 **Preferences Affected:** N/A
1060
1061 #### Windows
1062 ```
1063 Software\Policies\Mozilla\Firefox\DisplayMenuBar = 0x1 | 0x0
1064 ```
1065 #### macOS
1066 ```
1067 <dict>
1068   <key>DisplayMenuBar</key>
1069   <true/> | <false/>
1070 </dict>
1071 ```
1072 #### JSON
1073 ```
1074 {
1075   "policies": {
1076     "DisplayMenuBar": true | false
1077   }
1078 }
1079 ```
1080 ### DNSOverHTTPS
1081 Configure DNS over HTTPS.
1082
1083 `Enabled` determines whether DNS over HTTPS is enabled
1084
1085 `ProviderURL` is a URL to another provider.
1086
1087 `Locked` prevents the user from changing DNS over HTTPS preferences.
1088
1089 **Compatibility:** Firefox 63, Firefox ESR 68\
1090 **CCK2 Equivalent:** N/A\
1091 **Preferences Affected:** `network.trr.mode`,`network.trr.uri`
1092
1093 #### Windows
1094 ```
1095 Software\Policies\Mozilla\Firefox\Cookies\Enabled = 0x1 | 0x0
1096 Software\Policies\Mozilla\Firefox\Cookies\ProviderURL = "URL_TO_ALTERNATE_PROVIDER"
1097 Software\Policies\Mozilla\Firefox\Cookies\Locked = 0x1 | 0x0
1098 ```
1099 #### macOS
1100 ```
1101 <dict>
1102   <key>Cookies</key>
1103   <dict>
1104     <key>Enabled</key>
1105     <true/> | <false/>
1106     <key>ProviderURL</key>
1107     <string>URL_TO_ALTERNATE_PROVIDER</string>
1108     <key>Locked</key>
1109     <true/> | <false/>
1110   </dict>
1111 </dict>
1112 ```
1113 #### JSON
1114 ```
1115 {
1116   "policies": {
1117     "DNSOverHTTPS": {
1118       "Enabled":  true | false,
1119       "ProviderURL": "URL_TO_ALTERNATE_PROVIDER",
1120       "Locked": true | false
1121     }
1122   }
1123 }
1124 ```
1125 ### DontCheckDefaultBrowser
1126 Don't check if Firefox is the default browser at startup.
1127
1128 **Compatibility:** Firefox 60, Firefox ESR 60\
1129 **CCK2 Equivalent:** `dontCheckDefaultBrowser`\
1130 **Preferences Affected:** `browser.shell.checkDefaultBrowser`
1131
1132 #### Windows
1133 ```
1134 Software\Policies\Mozilla\Firefox\DontCheckDefaultBrowser = 0x1 | 0x0
1135 ```
1136 #### macOS
1137 ```
1138 <dict>
1139   <key>DontCheckDefaultBrowser</key>
1140   <true/> | <false/>
1141 </dict>
1142 ```
1143 #### JSON
1144 ```
1145 {
1146   "policies": {
1147     "DontCheckDefaultBrowser": true | false
1148   }
1149 }
1150 ```
1151 ### EnableTrackingProtection
1152 Configure tracking protection.
1153
1154 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.
1155
1156 If `Value` is set to false, tracking protection is disabled and locked in both the regular browser and private browsing.
1157
1158 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.
1159
1160 **Compatibility:** Firefox 60, Firefox ESR 60\
1161 **CCK2 Equivalent:** `dontCheckDefaultBrowser`\
1162 **Preferences Affected:** `privacy.trackingprotection.enabled`,`privacy.trackingprotection.pbmode.enabled`
1163
1164 #### Windows
1165 ```
1166 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Value = 0x1 | 0x0
1167 Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Locked = 0x1 | 0x0
1168 ```
1169 #### macOS
1170 ```
1171 <dict>
1172   <key>EnableTrackingProtection</key>
1173   <dict>
1174     <key>Value</key>
1175     <true/> | <false/>
1176
1177     <key><Locked/key>
1178     <true/> | <false/>
1179   </dict>
1180 </dict>
1181 ```
1182 #### JSON
1183 ```
1184 {
1185   "policies": {
1186     "EnableTrackingProtection": {
1187       "Value": [true, false],
1188       "Locked": [true, false]
1189     }
1190 }
1191 ```
1192 ### Extensions
1193 Control the installation, uninstallation and locking of extensions.
1194
1195 `Install` is a list of URLs or native paths for extensions to be installed.
1196
1197 `Uninstall` is a list of extension IDs that should be uninstalled if found.
1198
1199 `Locked` is a list of extension IDs that the user cannot disable or uninstall.
1200
1201 **Compatibility:** Firefox 60, Firefox ESR 60\
1202 **CCK2 Equivalent:** `addons`\
1203 **Preferences Affected:** N/A
1204
1205 #### Windows
1206 ```
1207 Software\Policies\Mozilla\Firefox\Extensions\Install\1 = "https://addons.mozilla.org/firefox/downloads/somefile.xpi"
1208 Software\Policies\Mozilla\Firefox\Extensions\Install\2 = "//path/to/xpi"
1209 Software\Policies\Mozilla\Firefox\Extensions\Uninstall\1 = "bad_addon_id@mozilla.org"
1210 Software\Policies\Mozilla\Firefox\Extensions\Locked\1 = "addon_id@mozilla.org"
1211 ```
1212 #### macOS
1213 ```
1214 <dict>
1215   <key>Extensions</key>
1216   <dict>
1217     <key>Install</key>
1218     <array>
1219       <string>https://addons.mozilla.org/firefox/downloads/somefile.xpi</string>
1220       <string>//path/to/xpi</string>
1221     </array>
1222     <key>Uninstall</key>
1223     <array>
1224       <string>bad_addon_id@mozilla.org</string>
1225     </array>
1226     <key>Locked</key>
1227     <array>
1228       <string>addon_id@mozilla.org</string>
1229     </array>
1230   </dict>
1231 </dict>
1232 ```
1233 #### JSON
1234
1235
1236 ```
1237 {
1238   "policies": {
1239     "Extensions": {
1240       "Install": ["https://addons.mozilla.org/firefox/downloads/somefile.xpi", "//path/to/xpi"],
1241       "Uninstall": ["bad_addon_id@mozilla.org"],
1242       "Locked":  ["addon_id@mozilla.org"]
1243     }
1244   }
1245 }
1246 ```
1247 ### ExtensionUpdate
1248 Control extension updates.
1249
1250 **Compatibility:** Firefox 67, Firefox ESR 60.7\
1251 **CCK2 Equivalent:** N/A\
1252 **Preferences Affected:** `extensions.update.enabled`
1253
1254 #### Windows
1255 ```
1256 Software\Policies\Mozilla\Firefox\ExtensionUpdate = 0x1 | 0x0
1257 ```
1258 #### macOS
1259 ```
1260 <dict>
1261   <key>ExtensionUpdate</key>
1262   <true/> | <false/>
1263 </dict>
1264 ```
1265 #### JSON
1266 ```
1267 {
1268   "policies": {
1269     "ExtensionUpdate": true | false
1270   }
1271 }
1272 ```
1273 ### FlashPlugin
1274 Configure the default Flash plugin policy as well as origins for which Flash is allowed.
1275
1276 `Allow` is a list of origins where Flash are allowed.
1277
1278 `Block` is a list of origins where Flash is not allowed.
1279
1280 `Default` determines whether or not Flash is allowed by default.
1281
1282 `Locked` prevents the user from changing Flash preferences.
1283
1284 **Compatibility:** Firefox 60, Firefox ESR 60\
1285 **CCK2 Equivalent:** `permissions.plugin`\
1286 **Preferences Affected:** `plugin.state.flash`
1287
1288 #### Windows
1289 ```
1290 Software\Policies\Mozilla\Firefox\FlashPlugin\Allow\1 = "https://example.org"
1291 Software\Policies\Mozilla\Firefox\FlashPlugin\Block\1 = "https://example.edu"
1292 Software\Policies\Mozilla\Firefox\FlashPlugin\Default = 0x1 | 0x0
1293 Software\Policies\Mozilla\Firefox\FlashPlugin\Locked = 0x1 | 0x0
1294 ```
1295 #### macOS
1296 ```
1297 <dict>
1298   <key>FlashPlugin</key>
1299   <dict>
1300     <key>Allow</key>
1301     <array>
1302       <string>http://example.org</string>
1303     </array>
1304     <key>Block</key>
1305     <array>
1306       <string>http://example.edu</string>
1307     </array>
1308     <key>Default</key>
1309     <true/> | <false/>
1310     <key>Locked</key>
1311     <true/> | <false/>
1312   </dict>
1313 </dict>
1314 ```
1315 #### JSON
1316 ```
1317 {
1318   "policies": {
1319     "FlashPlugin": {
1320       "Allow": ["http://example.org/"],
1321       "Block": ["http://example.edu/"],
1322       "Default": true | false,
1323       "Locked": true | false
1324     }
1325   }
1326 }
1327 ```
1328 ### HardwareAcceleration
1329 Control hardware acceleration.
1330
1331 **Compatibility:** Firefox 60, Firefox ESR 60\
1332 **CCK2 Equivalent:** N/A\
1333 **Preferences Affected:** `layers.acceleration.disabled`
1334
1335 #### Windows
1336 ```
1337 Software\Policies\Mozilla\Firefox\HardwareAcceleration = 0x1 | 0x0
1338 ```
1339 #### macOS
1340 ```
1341 <dict>
1342   <key>HardwareAcceleration</key>
1343   <true/> | <false/>
1344 </dict>
1345 ```
1346 #### JSON
1347 ```
1348 {
1349   "policies": {
1350     "HardwareAcceleration": true | false
1351   }
1352 }
1353 ```
1354 ### Homepage
1355 Configure the default homepage and how Firefox starts.
1356
1357 `URL` is the default homepage.
1358
1359 `Locked` prevents the user from changing homepage preferences.
1360
1361 `Additional` allows for more than one homepage.
1362
1363 `StartPage` is how Firefox starts. The choices are no homepage, the default homepage or the previous session.
1364
1365 **Compatibility:** Firefox 60, Firefox ESR 60 (StartPage was added in Firefox 60, Firefox ESR 60.4)\
1366 **CCK2 Equivalent:** `homePage`,`lockHomePage`\
1367 **Preferences Affected:** `browser.startup.homepage`,`browser.startup.page`
1368
1369 #### Windows
1370 ```
1371 Software\Policies\Mozilla\Firefox\Homepage\URL = "https://example.com"
1372 Software\Policies\Mozilla\Firefox\Homepage\Locked = 0x1 | 0x0
1373 Software\Policies\Mozilla\Firefox\Homepage\Additional\1 = "https://example.org"
1374 Software\Policies\Mozilla\Firefox\Homepage\Additional\2 = "https://example.edu"
1375 Software\Policies\Mozilla\Firefox\Homepage\StartPage = "none" | "homepage" |  "previous-session"
1376 ```
1377 #### macOS
1378 ```
1379 <dict>
1380   <key>Homepage</key>
1381   <dict>
1382     <key>URL</key>
1383     <string>http://example.com</string>
1384     <key>Locked</key>
1385     <true/> | <false/>
1386     <key>Additional</key>
1387     <array>
1388       <string>http://example.org</string>
1389       <string>http://example.edu</string>
1390     </array>
1391     <key>StartPage</key>
1392     <string>always | never | from-visited</string>
1393   </dict>
1394 </dict>
1395 ```
1396 #### JSON
1397 ```
1398 {
1399   "policies": {
1400     "Homepage": {
1401       "URL": "http://example.com/",
1402       "Locked": true | false,
1403       "Additional": ["http://example.org/",
1404                      "http://example.edu/"],
1405       "StartPage": "none" | "homepage" |  "previous-session"
1406     }
1407   }
1408 }
1409 ```
1410 ### InstallAddonsPermission
1411 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.
1412
1413 `Allow` is a list of origins where extension installs are allowed.
1414
1415 `Default` determines whether or not extension installs are allowed by default.
1416
1417 **Compatibility:** Firefox 60, Firefox ESR 60\
1418 **CCK2 Equivalent:** `permissions.install`\
1419 **Preferences Affected:** `xpinstall.enabled`
1420
1421 #### Windows
1422 ```
1423 Software\Policies\Mozilla\Firefox\InstallAddonsPermission\Allow\1 = "https://example.org"
1424 Software\Policies\Mozilla\Firefox\InstallAddonsPermission\Allow\2 = "https://example.edu"
1425 Software\Policies\Mozilla\Firefox\InstallAddonsPermission\Default = 0x1 | 0x0
1426 ```
1427 #### macOS
1428 ```
1429 <dict>
1430   <key>InstallAddonsPermission</key>
1431   <dict>
1432     <key>Allow</key>
1433     <array>
1434       <string>http://example.org</string>
1435       <string>http://example.edu</string>
1436     </array>
1437     <key>Default</key>
1438     <true/> | <false/>
1439   </dict>
1440 </dict>
1441 ```
1442 #### JSON
1443 ```
1444 {
1445   "policies": {
1446     "InstallAddonsPermission": {
1447       "Allow": ["http://example.org/",
1448                 "http://example.edu/"],
1449       "Default": true | false
1450     }
1451   }
1452 }
1453 ```
1454 ### NoDefaultBookmarks
1455 Disable the creation of default bookmarks.
1456
1457 This policy is only effective if the user profile has not been created yet.
1458
1459 **Compatibility:** Firefox 60, Firefox ESR 60\
1460 **CCK2 Equivalent:** `removeDefaultBookmarks`\
1461 **Preferences Affected:** N/A
1462
1463 #### Windows
1464 ```
1465 Software\Policies\Mozilla\Firefox\NoDefaultBookmarks = 0x1 | 0x0
1466 ```
1467 #### macOS
1468 ```
1469 <dict>
1470   <key>NoDefaultBookmarks</key>
1471   <true/> | <false/>
1472 </dict>
1473 ```
1474 #### JSON
1475 ```
1476 {
1477   "policies": {
1478     "NoDefaultBookmarks": true | false
1479   }
1480 }
1481 ```
1482 ### NetworkPrediction
1483 Enable or disable  network prediction (DNS prefetching).
1484
1485 **Compatibility:** Firefox 67, Firefox ESR 60.7\
1486 **CCK2 Equivalent:** N/A\
1487 **Preferences Affected:** `network.dns.disablePrefetch`,`network.dns.disablePrefetchFromHTTPS`
1488
1489 #### Windows
1490 ```
1491 Software\Policies\Mozilla\Firefox\NetworkPrediction = 0x1 | 0x0
1492 ```
1493 #### macOS
1494 ```
1495 <dict>
1496   <key>NetworkPrediction</key>
1497   <true/> | <false/>
1498 </dict>
1499 ```
1500 #### JSON
1501 ```
1502 {
1503   "policies": {
1504     "NetworkPrediction": true | false
1505 }
1506 ```
1507 ### OfferToSaveLogins
1508 Control whether or not Firefox offers to save passwords.
1509
1510 **Compatibility:** Firefox 60, Firefox ESR 60\
1511 **CCK2 Equivalent:** `dontRememberPasswords`\
1512 **Preferences Affected:** `signon.rememberSignons`
1513
1514 #### Windows
1515 ```
1516 Software\Policies\Mozilla\Firefox\OfferToSaveLogins = 0x1 | 0x0
1517 ```
1518 #### macOS
1519 ```
1520 <dict>
1521   <key>OfferToSaveLogins</key>
1522   <true/> | <false/>
1523 </dict>
1524 ```
1525 #### JSON
1526 ```
1527 {
1528   "policies": {
1529     "OfferToSaveLogins": true | false
1530   }
1531 }
1532 ```
1533 ### OverrideFirstRunPage
1534 Override the first run page. If the value is blank, no first run page is displayed.
1535
1536 **Compatibility:** Firefox 60, Firefox ESR 60\
1537 **CCK2 Equivalent:** `welcomePage`,`noWelcomePage`\
1538 **Preferences Affected:** `startup.homepage_welcome_url`
1539
1540 #### Windows
1541 ```
1542 Software\Policies\Mozilla\Firefox\OverrideFirstRunPage = "http://example.org"
1543 ```
1544 #### macOS
1545 ```
1546 <dict>
1547   <key>OverrideFirstRunPage</key>
1548   <string>http://example.org</string>
1549 </dict>
1550 ```
1551 #### JSON
1552 ```
1553 {
1554   "policies": {
1555     "OverrideFirstRunPage": ""http://example.org""
1556 }
1557 ```
1558 ### OverridePostUpdatePage
1559 Override the upgrade page. If the value is blank, no upgrade page is displayed.
1560
1561 **Compatibility:** Firefox 60, Firefox ESR 60\
1562 **CCK2 Equivalent:** `upgradePage`,`noUpgradePage`\
1563 **Preferences Affected:** `startup.homepage_override_url`
1564
1565 #### Windows
1566 ```
1567 Software\Policies\Mozilla\Firefox\OverridePostUpdatePage = "http://example.org"
1568 ```
1569 #### macOS
1570 ```
1571 <dict>
1572   <key>OverridePostUpdatePage</key>
1573   <string>http://example.org</string>
1574 </dict>
1575 ```
1576 #### JSON
1577 ```
1578 {
1579   "policies": {
1580     "OverridePostUpdatePage": ""http://example.org""
1581 }
1582 ```
1583 ### Permissions
1584 Set permissions associated with camera, microphone, location, and notifications
1585
1586 `Allow` is a list of origins where the feature is allowed.
1587
1588 `Block` is a list of origins where the feature is not allowed.
1589
1590 `BlockNewRequests` determines whether or not new requests can be made for the feature.
1591
1592 `Locked` prevents the user from changing preferences for the feature.
1593
1594 **Compatibility:** Firefox 62, Firefox ESR 60.2\
1595 **CCK2 Equivalent:** N/A\
1596 **Preferences Affected:** `permissions.default.camera`,`permissions.default.microphone`,`permissions.default.geo`,`permissions.default.desktop-notification`
1597
1598 #### Windows
1599 ```
1600 Software\Policies\Mozilla\Firefox\Permissions\Camera\Allow\1 = "https://example.org"
1601 Software\Policies\Mozilla\Firefox\Permissions\Camera\Block\1 = "https://example.edu"
1602 Software\Policies\Mozilla\Firefox\Permissions\Camera\BlockNewRequests = 0x1 | 0x0
1603 Software\Policies\Mozilla\Firefox\Permissions\Camera\Locked = 0x1 | 0x0
1604 Software\Policies\Mozilla\Firefox\Permissions\Microphone\Allow\1 = "https://example.org"
1605 Software\Policies\Mozilla\Firefox\Permissions\Microphone\Block\1 = "https://example.edu"
1606 Software\Policies\Mozilla\Firefox\Permissions\Microphone\BlockNewRequests = 0x1 | 0x0
1607 Software\Policies\Mozilla\Firefox\Permissions\Microphone\Locked = 0x1 | 0x0
1608 Software\Policies\Mozilla\Firefox\Permissions\Location\Allow\1 = "https://example.org"
1609 Software\Policies\Mozilla\Firefox\Permissions\Location\Block\1 = "https://example.edu"
1610 Software\Policies\Mozilla\Firefox\Permissions\Location\BlockNewRequests = 0x1 | 0x0
1611 Software\Policies\Mozilla\Firefox\Permissions\Location\Locked = 0x1 | 0x0
1612 Software\Policies\Mozilla\Firefox\Permissions\Notifications\Allow\1 = "https://example.org"
1613 Software\Policies\Mozilla\Firefox\Permissions\Notifications\Block\1 = "https://example.edu"
1614 Software\Policies\Mozilla\Firefox\Permissions\Notifications\BlockNewRequests = 0x1 | 0x0
1615 Software\Policies\Mozilla\Firefox\Permissions\Notifications\Locked = 0x1 | 0x0
1616 ```
1617 #### macOS
1618 ```
1619 <dict>
1620   <key>Permissions</key>
1621   <dict>
1622     <key>Camera</key>
1623     <dict>
1624       <key>Allow</key>
1625       <array>
1626         <string>https://example.org</string>
1627       </array>
1628       <key>Block</key>
1629       <array>
1630         <string>https://example.edu</string>
1631       </array>
1632       <key>BlockNewRequests</key>
1633       <true/>
1634       <key>Locked</key>
1635       <true/>
1636     </dict>
1637     <key>Microphone</key>
1638     <dict>
1639       <key>Allow</key>
1640       <array>
1641         <string>https://example.org</string>
1642       </array>
1643       <key>Block</key>
1644       <array>
1645         <string>https://example.edu</string>
1646       </array>
1647       <key>BlockNewRequests</key>
1648       <true/>
1649       <key>Locked</key>
1650       <true/>
1651     </dict>
1652     <key>Location</key>
1653     <dict>
1654       <key>Allow</key>
1655       <array>
1656         <string>https://example.org</string>
1657       </array>
1658       <key>Block</key>
1659       <array>
1660         <string>https://example.edu</string>
1661       </array>
1662       <key>BlockNewRequests</key>
1663       <true/>
1664       <key>Locked</key>
1665       <true/>
1666     </dict>
1667     <key>Notifications</key>
1668     <dict>
1669       <key>Allow</key>
1670       <array>
1671         <string>https://example.org</string>
1672       </array>
1673       <key>Block</key>
1674       <array>
1675         <string>https://example.edu</string>
1676       </array>
1677       <key>BlockNewRequests</key>
1678       <true/>
1679       <key>Locked</key>
1680       <true/>
1681     </dict>
1682   </dict>
1683 </dict>
1684 ```
1685 #### JSON
1686 ```
1687 {
1688   "policies": {
1689     "Permissions": {
1690       "Camera": {
1691         "Allow": ["https://example.org"],
1692         "Block": ["https://example.edu"],
1693         "BlockNewRequests": true | false,
1694         "Locked": true | false
1695       },
1696       "Microphone": {
1697         "Allow": ["https://example.org"],
1698         "Block": ["https://example.edu"],
1699         "BlockNewRequests": true | false,
1700         "Locked": true | false
1701       },
1702       "Location": {
1703         "Allow": ["https://example.org"],
1704         "Block": ["https://example.edu"],
1705         "BlockNewRequests": true | false,
1706         "Locked": true | false
1707       },
1708       "Notifications": {
1709         "Allow": ["https://example.org"],
1710         "Block": ["https://example.edu"],
1711         "BlockNewRequests": true | false,
1712         "Locked": true | false
1713       }
1714     }
1715   }
1716 }
1717 ```
1718 ### PopupBlocking
1719 Configure the default pop-up window policy as well as origins for which pop-up windows are allowed.
1720
1721 `Allow` is a list of origins where popup-windows are allowed.
1722
1723 `Default` determines whether or not pop-up windows are allowed by default.
1724
1725 `Locked` prevents the user from changing pop-up preferences.
1726
1727 **Compatibility:** Firefox 60, Firefox ESR 60\
1728 **CCK2 Equivalent:** `permissions.popup`\
1729 **Preferences Affected:** `dom.disable_open_during_load`
1730
1731 #### Windows
1732 ```
1733 Software\Policies\Mozilla\Firefox\PopupBlocking\Allow\1 = "https://example.org"
1734 Software\Policies\Mozilla\Firefox\PopupBlocking\Allow\2 = "https://example.edu"
1735 Software\Policies\Mozilla\Firefox\PopupBlocking\Default = 0x1 | 0x0
1736 Software\Policies\Mozilla\Firefox\PopupBlocking\Locked = 0x1 | 0x0
1737 ```
1738 #### macOS
1739 ```
1740 <dict>
1741   <key>PopupBlocking</key>
1742   <dict>
1743     <key>Allow</key>
1744     <array>
1745       <string>http://example.org</string>
1746       <string>http://example.edu</string>
1747     </array>
1748     <key>Default</key>
1749     <true/> | <false/>
1750     <key>Locked</key>
1751     <true/> | <false/>
1752   </dict>
1753 </dict>
1754 ```
1755 #### JSON
1756 ```
1757 {
1758   "policies": {
1759     "PopupBlocking": {
1760       "Allow": ["http://example.org/",
1761                 "http://example.edu/"],
1762       "Default": true | false,
1763       "Locked": true | false
1764     }
1765   }
1766 }
1767 ```
1768 ### Preferences
1769 Set and lock certain preferences.
1770
1771 **Compatibility:** See below\
1772 **CCK2 Equivalent:** `preferences`\
1773 **Preferences Affected:** See below
1774
1775 | Preference | Type | Compatibility
1776 | --- | --- | ---
1777 | app.update.auto | boolean | Firefox 68, Firefox 68 ESR
1778 | browser.cache.disk.enable | boolean | Firefox 68, Firefox 68 ESR
1779 | browser.cache.disk.parent_directory | string | Firefox 68, Firefox 68 ESR
1780 | browser.fixup.dns_first_for_single_words | boolean | Firefox 68, Firefox 68 ESR
1781 | browser.search.update | boolean | Firefox 68, Firefox 68 ESR
1782 | browser.tabs.warnOnClose | boolean | Firefox 68, Firefox 68 ESR
1783 | browser.urlbar.suggest.bookmark | boolean | Firefox 68, Firefox 68 ESR
1784 | browser.urlbar.suggest.history | boolean | Firefox 68, Firefox 68 ESR
1785 | browser.urlbar.suggest.openpage | boolean | Firefox 68, Firefox 68 ESR
1786 | datareporting.policy.dataSubmissionPolicyBypassNotification | boolean | Firefox 68, Firefox 68 ESR
1787 | dom.disable_window_flip | boolean | Firefox 68, Firefox 68 ESR
1788 | dom.disable_window_move_resize | boolean | Firefox 68, Firefox 68 ESR
1789 | dom.event.contextmenu.enabled | boolean | Firefox 68, Firefox 68 ESR
1790 | dom.keyboardevent.keypress.hack.dispatch_non_printable_keys.addl | string | Firefox 68, Firefox 68 ESR
1791 | dom.keyboardevent.keypress.hack.use_legacy_keycode_and_charcode.addl | string | Firefox 68, Firefox 68 ESR
1792 | extensions.getAddons.showPane | boolean | Firefox 68, Firefox 68 ESR
1793 | media.gmp-gmpopenh264.enabled | boolean | Firefox 68, Firefox 68 ESR
1794 | media.gmp-widevinecdm.enabled | boolean | Firefox 68, Firefox 68 ESR
1795 | network.dns.disableIPv6 | boolean | Firefox 68, Firefox 68 ESR
1796 | network.IDN_show_punycode | boolean | Firefox 68, Firefox 68 ESR
1797 | places.history.enabled | boolean | Firefox 68, Firefox 68 ESR
1798 | security.default_personal_cert | string | Firefox 68, Firefox 68 ESR
1799 | security.ssl.errorReporting.enabled | boolean | Firefox 68, Firefox 68 ESR
1800 | ui.key.menuAccessKeyFocuses | boolean | Firefox 68, Firefox 68 ESR
1801 #### Windows
1802 ```
1803 Software\Policies\Mozilla\Firefox\Preferences\boolean_preference_name = 0x1 | 0x0
1804 Software\Policies\Mozilla\Firefox\Preferences\string_preference_name = "string_value"
1805 ```
1806 #### macOS
1807 ```
1808 <dict>
1809   <key>Preference</key>
1810   <dict>
1811     <key>boolean_preference_name</key>
1812     <true/> | <false/>
1813     <key>string_preference_name</key>
1814     <string>string_value</string>
1815   </dict>
1816 </dict>
1817 ```
1818 #### JSON
1819 ```
1820 {
1821   "policies": {
1822     "Preference": {
1823       "boolean_preference_name": true | false,
1824       "string_preference_name": "string_value"
1825     }
1826   }
1827 }
1828 ```
1829 ### Proxy
1830 Configugre proxy settings. These settings correspond to the connection settings in Firefox preferences.
1831 To specify ports, append them to the hostnames with a colon (:).
1832
1833 `Mode` is the proxy method being used.
1834
1835 `Locked` is whether or not proxy settings can be changed.
1836
1837 `HTTPProxy` is the HTTP proxy server.
1838
1839 `UseHTTPProxyForAllProtocols` is whether or not the HTTP proxy should be used for all other proxies.
1840
1841 `SSLProxy` is the SSL proxy server.
1842
1843 `FTPProxy` is the FTP proxy server.
1844
1845 `SOCKSProxy` is the SOCKS proxy server
1846
1847 `SOCKSVersion` is the SOCKS version (4 or 5)
1848
1849 `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.
1850
1851 `AutoConfigURL` is a  URL for proxy configuration (only used if Mode is autoConfig).
1852
1853 `AutoLogin` means do not prompt for authentication if password is saved.
1854
1855 `UseProxyForDNS` to use proxy DNS when using SOCKS v5.
1856
1857 **Compatibility:** Firefoox 60, Firefox ESR 60\
1858 **CCK2 Equivalent:** `networkProxy*`\
1859 **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`
1860
1861 #### Windows
1862 ```
1863 Software\Policies\Mozilla\Firefox\Proxy\Mode = "none", "system", "manual", "autoDetect", "autoConfig"
1864 Software\Policies\Mozilla\Firefox\Proxy\Locked = 0x1 | 0x0
1865 Software\Policies\Mozilla\Firefox\=Proxy\HTTPProxy = https://httpproxy.example.com
1866 Software\Policies\Mozilla\Firefox\Proxy\UseHTTPProxyForAllProtocols = 0x1 | 0x0
1867 Software\Policies\Mozilla\Firefox\Proxy\SSLProxy = https://sslproxy.example.com
1868 Software\Policies\Mozilla\Firefox\Proxy\FTPProxy = https://ftpproxy.example.com
1869 Software\Policies\Mozilla\Firefox\Proxy\SOCKSProxy = https://socksproxy.example.com
1870 Software\Policies\Mozilla\Firefox\Proxy\SOCKSVersion = 0x4 | 0x5
1871 Software\Policies\Mozilla\Firefox\Proxy\Passthrough = <local>
1872 Software\Policies\Mozilla\Firefox\Proxy\AutoConfigURL = URL_TO_AUTOCONFIG
1873 Software\Policies\Mozilla\Firefox\Proxy\AutoLogin = 0x1 | 0x0
1874 Software\Policies\Mozilla\Firefox\Proxy\UseProxyForDNS = 0x1 | 0x0
1875 ```
1876 #### macOS
1877 ```
1878 <dict>
1879   <key>Proxy</key>
1880   <dict>
1881     <key>Mode</key>
1882     <string>none | system | manual | autoDetect| autoConfig</string>
1883     <key>Locked</key>
1884     <true> | </false>
1885     <key>HTTPProxy</key>
1886     <string>https://httpproxy.example.com</string>
1887     <key>UseHTTPProxyForAllProtocols</key>
1888     <true> | </false>
1889     <key>SSLProxy</key>
1890     <string>https://sslproxy.example.com</string>
1891     <key>FTPProxy</key>
1892     <string>https://ftpproxy.example.com</string>
1893     <key>SOCKSProxy</key>
1894     <string>https://socksproxy.example.com</string>
1895     <key>SOCKSVersion</key>
1896     <string>4 | 5</string>
1897     <key>Passthrough</key>
1898     <string>&lt;local>&gt;</string>
1899     <key>AutoConfigURL</key>
1900     <string>URL_TO_AUTOCONFIG</string>
1901     <key>AutoLogin</key>
1902     <true> | </false>
1903     <key>UseProxyForDNS</key>
1904     <true> | </false>
1905   </dict>
1906 </dict>
1907 ```
1908 ### JSON
1909 ```
1910 {
1911   "policies": {
1912     "Proxy": {
1913       "Mode": "none", "system", "manual", "autoDetect", "autoConfig",
1914       "Locked": [true, false],
1915       "HTTPProxy": "hostname",
1916       "UseHTTPProxyForAllProtocols": [true, false],
1917       "SSLProxy": "hostname",
1918       "FTPProxy": "hostname",
1919       "SOCKSProxy": "hostname",
1920       "SOCKSVersion": 4 | 5
1921       "Passthrough": "<local>",
1922       "AutoConfigURL": "URL_TO_AUTOCONFIG",
1923       "AutoLogin":  [true, false],
1924       "UseProxyForDNS": [true, false]
1925     }
1926   }
1927 }
1928 ```
1929 ### RequestedLocales
1930 Set the the list of requested locales for the application in order of preference. It will cause the corresponding language pack to become active.
1931
1932 **Compatibility:** Firefox 64, Firefox ESR 60.4\
1933 **CCK2 Equivalent:** N/A\
1934 **Preferences Affected:** N/A
1935 #### Windows
1936 ```
1937 Software\Policies\Mozilla\Firefox\RequestedLocales\1 = "de"
1938 Software\Policies\Mozilla\Firefox\RequestedLocales\2 = "en-US"
1939 ```
1940 #### macOS
1941 ```
1942 <dict>
1943   <key>RequestedLocales</key>
1944   <array>
1945     <string>de</string>
1946     <string>en-US</string>
1947   </array>
1948 </dict>
1949 ```
1950 #### JSON
1951 ```
1952 {
1953   "policies": {
1954     "RequestedLocales": ["de", "en-US"]
1955   }
1956 }
1957 ```
1958 ### SanitizeOnShutdown
1959 Clear all data on shutdown, including Browsing & Download History, Cookies, Active Logins, Cache, Form & Search History, Site Preferences and Offline Website Data.
1960
1961 **Compatibility:** Firefox 60, Firefox ESR 60\
1962 **CCK2 Equivalent:** N/A\
1963 **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`
1964 #### Windows
1965 ```
1966 Software\Policies\Mozilla\Firefox\SanitizeOnShutdown = 0x1 | 0x0
1967 ```
1968 #### macOS
1969 ```
1970 <dict>
1971   <key>SanitizeOnShutdown</key>
1972   <true/> | <false/>
1973 </dict>
1974 ```
1975 #### JSON
1976 ```
1977 {
1978   "policies": {
1979     "SanitizeOnShutdown": true | false
1980   }
1981 }
1982 ```
1983 ### SearchBar
1984 Set whether or not search bar is displayed.
1985
1986 **Compatibility:** Firefox 60, Firefox ESR 60\
1987 **CCK2 Equivalent:** `showSearchBar`\
1988 **Preferences Affected:** N/A
1989
1990 #### Windows
1991 ```
1992 Software\Policies\Mozilla\Firefox\SearchBar = "unified" | "separate"
1993 ```
1994 #### macOS
1995 ```
1996 <dict>
1997   <key>SearchBar</key>
1998   <string>unified | separate</string>
1999 </dict>
2000 ```
2001
2002 #### JSON
2003 ```
2004 {
2005   "policies": {
2006     "SearchBar": "unified" | "separate"
2007   }
2008 }
2009 ```
2010
2011
2012
2013
2014
2015 ### SearchEngines (This policy is only available on the ESR.)
2016
2017 ### SearchEngines | Default
2018
2019 Set the default search engine. This policy is only available on the ESR.
2020
2021 **Compatibility:** Firefox ESR 60\
2022 **CCK2 Equivalent:** `defaultSearchEngine`\
2023 **Preferences Affected:** N/A
2024
2025 ### Windows
2026 ```
2027 Software\Policies\Mozilla\Firefox\SearchEngines\Default = NAME_OF_SEARCH_ENGINE
2028 ```
2029 #### macOS
2030 ```
2031 <dict>
2032   <key>SearchEngines</key>
2033   <dict>
2034     <key>Default</key>
2035     <string>NAME_OF_SEARCH_ENGINE</string>
2036   </dict>
2037 </dict>
2038 ```
2039 ### JSON
2040 ```
2041 {
2042   "policies": {
2043     "SearchEngines": {
2044       "Default": "NAME_OF_SEARCH_ENGINE"
2045     }
2046   }
2047 }
2048 ```
2049 ### SearchEngines | PreventInstalls
2050
2051 Prevent installing search engines from webpages.
2052
2053 **Compatibility:** Firefox ESR 60\
2054 **CCK2 Equivalent:** `disableSearchEngineInstall`\
2055 **Preferences Affected:** N/A
2056
2057 ### Windows
2058 ```
2059 Software\Policies\Mozilla\Firefox\SearchEngines\PreventInstalls = 0x1 | 0x0
2060 ```
2061 #### macOS
2062 ```
2063 <dict>
2064   <key>SearchEngines</key>
2065   <dict>
2066     <key>PreventInstalls</key>
2067     <true/> | <false/>
2068   </dict>
2069 </dict>
2070 ```
2071 ### JSON
2072 ```
2073 {
2074   "policies": {
2075     "SearchEngines": {
2076       "PreventInstalls": true | false
2077     }
2078   }
2079 }
2080 ```
2081 ### SearchEngines | Remove
2082
2083 Hide built-in search engines. This policy is only available on the ESR.
2084
2085 **Compatibility:** Firefox ESR 60.2\
2086 **CCK2 Equivalent:** `removeDefaultSearchEngines` (removed all built-in engines)\
2087 **Preferences Affected:** N/A
2088
2089 ### Windows
2090 ```
2091 Software\Policies\Mozilla\Firefox\SearchEngines\Remove\1 = NAME_OF_SEARCH_ENGINE
2092 ```
2093 #### macOS
2094 ```
2095 <dict>
2096   <key>SearchEngines</key>
2097   <dict>
2098     <key>Remove</key>
2099     <array>
2100       <string>NAME_OF_SEARCH_ENGINE</string>
2101     </array>
2102   </dict>
2103 </dict>
2104 ```
2105 ### JSON
2106 ```
2107 {
2108   "policies": {
2109     "SearchEngines": {
2110       "Remove": ["NAME_OF_SEARCH_ENGINE"]
2111     }
2112   }
2113 }
2114 ```
2115 ### SearchEngines | Add
2116
2117 Adddd new search engines (up to five). This policy is only available on the ESR. `Name` and `URLTemplate` are required.
2118
2119 `Name` is the name of the search engine.
2120
2121 `URLTemplate` is the search URL with {searchTerms} to substitute for the search term.
2122
2123 `Method` is either GET or POST
2124
2125 `IconURL` is a URL for the icon to use.
2126
2127 `Alias` is a keyword to use for the engine.
2128
2129 `Description` is a description of the search engine.
2130
2131 `SuggestURLTemplate` is a search suggestions URL with {searchTerms} to substitute for the search term.
2132
2133 **Compatibility:** Firefox ESR 60\
2134 **CCK2 Equivalent:** `searchplugins`\
2135 **Preferences Affected:** N/A
2136
2137 #### Windows
2138 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\Name = "Example1"
2139 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\URLTemplate = "https://www.example.org/q={searchTerms}"
2140 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\Method = "GET" | "POST"
2141 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\IconURL = "https://www.example.org/favicon.ico"
2142 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\Alias = "example"
2143 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\Description = "Example Description"
2144 Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\SuggestURLTemplate = "https://www.example.org/suggestions/q={searchTerms}"
2145
2146 #### macOS
2147 ```
2148 <dict>
2149   <key>SearchEngines</key>
2150   <dict>
2151     <key>Add</key>
2152     <array>
2153       <dict>
2154         <key>Name</key>
2155         <string>Example1</string>
2156         <key>URLTemplate</key>
2157         <string>https://www.example.org/q={searchTerms}</string>
2158         <key>Method</key>
2159         <string>GET | POST </string>
2160         <key>IconURL</key>
2161         <string>https://www.example.org/favicon.ico</string>
2162         <key>Alias</key>
2163         <string>example</string>
2164         <key>Description</key>
2165         <string>Example Description</string>
2166         <key>SuggestURLTemplate</key>
2167         <string>https://www.example.org/suggestions/q={searchTerms}</string>
2168       </dict>
2169     <array>
2170   </dict>
2171 </dict>
2172 ```
2173 ### JSON
2174 ```
2175 {
2176   "policies": {
2177     "SearchEngines": {
2178       "Add": [
2179         {
2180           "Name": "Example1",
2181           "URLTemplate": "https://www.example.org/q={searchTerms}",
2182           "Method": "GET" | "POST",
2183           "IconURL": "https://www.example.org/favicon.ico",
2184           "Alias": "example",
2185           "Description": "Description",
2186           "SuggestURLTemplate": "https://www.example.org/suggestions/q={searchTerms}"
2187         }
2188       ]
2189     }
2190   }
2191 }
2192 ```
2193 ### SecurityDevices
2194
2195 Install PKCS #11 modules.
2196
2197 **Compatibility:** Firefox 64, Firefox ESR 60.4\
2198 **CCK2 Equivalent:** `certs.devices`\
2199 **Preferences Affected:** N/A
2200
2201 #### Windows
2202 ```
2203 Software\Policies\Mozilla\Firefox\SecurityDevices\NAME_OF_DEVICE = PATH_TO_LIBRARY_FOR_DEVICE
2204 ```
2205 #### macOS
2206 ```
2207 <dict>
2208   <key>SecurityDevices</key>
2209   <dict>
2210     <key>NAME_OF_DEVICE</key>
2211     <string>PATH_TO_LIBRARY_FOR_DEVICE</string>
2212   </dict>
2213 </dict>
2214 ```
2215
2216 #### JSON
2217 ```
2218 {
2219   "policies": {
2220     "SecurityDevices": {
2221       "NAME_OF_DEVICE": "PATH_TO_LIBRARY_FOR_DEVICE"
2222     }
2223   }
2224 }
2225 ```
2226 ### SSLVersionMax
2227
2228 Set and lock the maximum version of TLS.
2229
2230 **Compatibility:** Firefox 66, Firefox ESR 60.6\
2231 **CCK2 Equivalent:** N/A\
2232 **Preferences Affected:** `security.tls.version.max`
2233
2234 #### Windows
2235 ```
2236 Software\Policies\Mozilla\Firefox\SSLVersionMax = "tls1" | "tls1.1" | "tls1.2" | "tls1.3"
2237 ```
2238 #### macOS
2239 ```
2240 <dict>
2241   <key>SSLVersionMax</key>
2242   <string>tls1 | tls1.1 | tls1.2 | tls1.3</string>
2243 </dict>
2244 ```
2245
2246 #### JSON
2247 ```
2248 {
2249   "policies": {
2250     "SSLVersionMax": "tls1" | "tls1.1" | "tls1.2" | "tls1.3"
2251   }
2252 }
2253 ```
2254 ### SSLVersionMin
2255
2256 Set and lock the minimum version of TLS.
2257
2258 **Compatibility:** Firefox 66, Firefox ESR 60.6\
2259 **CCK2 Equivalent:** N/A\
2260 **Preferences Affected:** `security.tls.version.min`
2261
2262 #### Windows
2263 ```
2264 Software\Policies\Mozilla\Firefox\SSLVersionMin = "tls1" | "tls1.1" | "tls1.2" | "tls1.3"
2265 ```
2266 #### macOS
2267 ```
2268 <dict>
2269   <key>SSLVersionMin</key>
2270   <string>tls1 | tls1.1 | tls1.2 | tls1.3</string>
2271 </dict>
2272 ```
2273
2274 #### JSON
2275 ```
2276 {
2277   "policies": {
2278     "SSLVersionMin": "tls1" | "tls1.1" | "tls1.2" | "tls1.3"
2279   }
2280 }
2281 ```
2282 ### WebsiteFilter
2283 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. Only http/https addresses are supported at the moment. The arrays are limited to 1000 entries each.
2284
2285 **Compatibility:** Firefox 60, Firefox ESR 60\
2286 **CCK2 Equivalent:** N/A\
2287 **Preferences Affected:** N/A
2288
2289 #### Windows
2290 ```
2291 Software\Policies\Mozilla\Firefox\WebsiteFilters\Block\1 = "<all_urls>"
2292 Software\Policies\Mozilla\Firefox\WebsiteFilters\Exceptions\1 = "http://example.org/*"
2293 ```
2294 #### macOS
2295 ```
2296 <dict>
2297   <key>WebsiteFilter</key>
2298   <dict>
2299     <key>Block</key>
2300     <array>
2301       <string><all_urls></string>
2302     </array>
2303     <key>Exceptions</key>
2304     <array>
2305       <string>http://example.org/*</string>
2306     </array>
2307   </dict>
2308
2309 </dict>
2310 ```
2311 ### JSON
2312 ```
2313 {
2314   "policies": {
2315     "WebsiteFilter": {
2316       "Block": ["<all_urls>"],
2317       "Exceptions": ["http://example.org/*"]
2318     }
2319   }
2320 }
2321 ```