]> git.p6c8.net - policy-templates.git/blob - README.md
git.p6c8.net / policy-templates.git / blob
? search:


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

patrick-canterino.de