PayloadKit

Firefox

org.mozilla.firefox

Configures Firefox settings. Firefox 78 is the last major release with support for macOS versions 10.9, 10.10 and 10.11.

macOS
macOS 10.12+undefined

Configuration Keys (91)

Showing 91 of 91 keys

KeyTypeDescriptionDefaultRange

Enable Enterprise Policies

required
booleanEnable policy support on macOS.Default: trueRange: —
string—Default: —Range: —
string—Default: —Range: —
string—Default: —Range: —
string—Default: —Range: —

Background App Update

booleanEnable or disable automatic application update in the background, when the application is not running. 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.Default: —Range: —

Firefox Auto Update

booleanEnable or disable automatic application update.Default: —Range: —

Application Update URL

stringChange the URL for application update.Default: —Range: —
dictConfigure sites that support integrated authentication.Default: —Range: —
SPNEGOarray

SPNEGO

arrayIf this preference is enabled, the specified websites are permitted to engage in SPNEGO authentication with the browser. Entries in the list are formatted as mydomain.com or https://myotherdomain.com. If this preference is disabled or not configured, no websites are permitted to engage in SPNEGO authentication with the browser. For more information, see https://developer.mozilla.org/en-US/docs/Mozilla/Integrated_authentication.Default: —Range: —
Domainstring
string—Default: —Range: —

Delegated

arrayIf this preference is enabled, the browser may delegate user authorization to the server for the specified websites. Entries in the list are formatted as mydomain.com or https://myotherdomain.com. If this preference is disabled or not configured, the browser will not delegate user authorization to the server for any websites. For more information, see https://developer.mozilla.org/en-US/docs/Mozilla/Integrated_authenticationDefault: —Range: —
Domainstring
string—Default: —Range: —
NTLMarray

Microsoft Challenge/Response (NTLM)

arrayIf this preference is enabled, the specified websites are trusted to use NTLM authentification. Entries in the list are formatted as mydomain.com or https://myotherdomain.com. If this policy is disabled or not configured, no websites are trusted to use NTLM authentification. For more information, see https://developer.mozilla.org/en-US/docs/Mozilla/Integrated_authentication.Default: —Range: —
Domainstring
string—Default: —Range: —

Allow Non-FQDN

dictIf this preference is enabled, you can always allow SPNEGO or NTLM on non FQDNs (fully qualified domain names). If this preference is disabled or not configured, NTLM and SPNEGO are not enabled on non FQDNs.Default: —Range: —
NTLMboolean
required
boolean—Default: trueRange: —
SPNEGOboolean
required
boolean—Default: trueRange: —

Allow Proxies

dictIf this preference is enabled, you can always allow SPNEGO or NTLM on non FQDNs (fully qualified domain names). If this preference is disabled or not configured, NTLM and SPNEGO are not enabled on non FQDNs.Default: —Range: —
NTLMboolean
required
boolean—Default: trueRange: —
SPNEGOboolean
required
boolean—Default: trueRange: —
Lockedboolean

Locked (Authentication)

boolean—Default: —Range: —

Private Browsing

booleanEnables integrated authentication in prviate browsingDefault: —Range: —

Block about:addons page

booleanBlock access to the Add-ons Manager (about:addons).Default: —Range: —

Block about:config page

booleanBlock access to about:config.Default: —Range: —

Block about:profiles page

booleanBlock access to About Profiles (about:profiles).Default: —Range: —

Block about:support page

booleanBlock access to Troubleshooting Information (about:support).Default: —Range: —
arrayAdd bookmarks in either the bookmarks toolbar or menu.Default: —Range: —
dict—Default: —Range: —
Titlestring
required
stringBookmark TitleDefault: —Range: —
URLstring
required
stringFull URL to be bookmarked (e.g. https://www.example.org/)Default: —Range: —
Placementstring
stringPlace bookmark in either the Bookmark menu or Bookmark Toolbar.Default: —Range: toolbar (toolbar), menu (menu)
Faviconstring
stringURL to icon file to display on bookmark (e.g. https://www.example.org/favicon.ico)Default: —Range: —
Folderstring
stringFolder to place bookmark in. If a folder is specified, it is automatically created and bookmarks with the same folder name are grouped together. You cannot nest folders.Default: —Range: —

Default Download Directory

stringSet the default download directory.Default: —Range: —

Disable Application Update

booleanTurn off application updates.Default: —Range: —

Disable Built-in PDF Viewer

booleanDisable the built in PDF viewer. PDF files are downloaded and sent externally.Default: —Range: —
PDFjsdict

PDF.js

dictDisable or configure PDF.js, the built-in PDF viewer.Default: —Range: —
Enabledboolean
booleanIf Enabled is set to false, the built-in PDF viewer is disabled.Default: —Range: —
booleanIf EnablePermissions is set to true, the built-in PDF viewer will honor document permissions like preventing the copying of text.Default: —Range: —

Disable Developer Tools

booleanRemove access to all developer tools.Default: —Range: —

Disable Feedback Commands

booleanDisable the menus for reporting sites (Submit Feedback, Report Deceptive Site).Default: —Range: —

Disable Firefox Accounts / Sync

booleanDisable Firefox Accounts integration (Sync).Default: —Range: —

Disable Firefox Screenshots

booleanRemove access to Firefox Screenshots.Default: —Range: —

Disable Firefox Studies (Shield)

booleanDisable Firefox studies (Shield).Default: —Range: —

Disable Forget Button

booleanDisable the "Forget" button.Default: —Range: —

Disable Master Password Creation

booleanRemove the master password functionality. If this preference is set to true, the master password functionality is removed.Default: —Range: —

Enable Primary Password

booleanRequire or prevent using a primary (formerly master) password. If this value is true, a primary password is required.Default: —Range: —

Disable Pocket

booleanRemove Pocket in the Firefox UI.Default: —Range: —

Disable Private Browsing

booleanRemove access to private browsing.Default: —Range: —

Disable Profile Import

booleanDisables the "Import data from another browser" option in the bookmarks window.Default: —Range: —

Disable Profile Refresh

booleanDisable 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.Default: —Range: —

Disable Safe Mode

booleanDisable safe mode within the browser.Default: —Range: —

Disable Set Desktop Background

booleanThis preference removes the "Set As Desktop Background..." menu item when right clicking on an image.Default: —Range: —

Display Menu Bar

booleanSet the initial state of the menubar. A user can still hide it and it will stay hidden.Default: —Range: —

Disable System Add-on Update

booleanPrevent system add-ons from being installed or update.Default: —Range: —

Display Bookmarks Toolbar

booleanSet the initial state of the bookmarks toolbar. A user can still hide it and it will stay hidden.Default: —Range: —

Do Not Check Default Browser

booleanDon't check if Firefox is the default browser at startup.Default: —Range: —

Download Directory

stringSet and lock the download directory.Default: —Range: —
dictControl the installation, uninstallation and locking of extensions. Locked extensions cannot be disabled or uninstalled. For Install, you specify a list of URLs or paths. For Uninstall and Locked, you specify extension IDs.Default: —Range: —
Installarray

Install

arrayA list of URLs or native paths for extensions to be installed.Default: —Range: —
Installstring

Install

string—Default: —Range: —

Uninstall

arrayA list of extension IDs that should be uninstalled if found.Default: —Range: —
Uninstallstring

Extension ID To Uninstall

string—Default: —Range: —
Lockedarray

Locked

arrayA list of extension IDs that the user cannot disable or uninstall.Default: —Range: —
Lockedstring

Extension ID To Lock

string—Default: —Range: —
dictManage all aspects of extensions. 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.Default: —Range: —
{{key}}string

Extension ID

string—Default: —Range: —
dict—Default: —Range: —

Installation Mode

stringMaps to a string indicating the installation mode for the extension.Default: —Range: Allowed (default behavior) (allowed), Blocked (blocked), Force Installed (force_installed), Normal Installed (normal_installed)

Install URL

stringMaps to a string indicating where Firefox can download a force_installed or normal_installed extension. 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. If installing from the local file system, use a file:/// URL. Languages packs are available from https://releases.mozilla.org/pub/firefox/releases/VERSION/PLATFORM/xpi/LANGUAGE.xpi.Default: —Range: —

Install Sources

arrayEach item in this list is an extension-style match pattern.Default: —Range: —
string
string—Default: —Range: —

Allowed Types

arrayThis setting allowlists the allowed types of extension/apps that can be installed in Firefox.Default: —Range: —
string
string—Default: —Range: extension, theme, dictionary, langpack
stringThis maps to a string specifying the error message to display to users if they're blocked from installing an extension.Default: —Range: —

Restricted Domains

arrayAn array of domains on which content scripts can't be run.Default: —Range: —
string

Restricted Domain

string—Default: —Range: —

Disable Updates

booleanIndicates whether or not to disable automatic updates for an individual extension.Default: —Range: —

Extension Update

boolean—Default: —Range: —

3rd Party Configuration

dictConfigure third party components.Default: —Range: —

3rd Party Extension Configuration

dictConfigure third party extensions. Keys in this dictionary specify IDs of extensions to configure, and values are dictionaries containing each third party extension configuration.Default: —Range: —
{{key}}string

Extension ID

string—Default: —Range: —

Extension Configuration

dict—Default: —Range: —

Encrypted Media Extensions

dictEnable or disable Encrypted Media Extensions and optionally lock it.Default: —Range: —
Enabledboolean
booleanIf Enabled is set to false, encrypted media extensions (like Widevine) are not downloaded by Firefox unless the user consents to installing them.Default: —Range: —
Lockedboolean
booleanIf 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.Default: —Range: —

Hardware Acceleration

booleanControl hardware acceleration.Default: —Range: —

FirefoxHome

dictCustomize the Firefox Home page.Default: —Range: —
Searchboolean

Search

boolean—Default: falseRange: —
TopSitesboolean

TopSites

boolean—Default: falseRange: —

Sponsored Top Sites

boolean—Default: falseRange: —
Highlightsboolean

Highlights

boolean—Default: falseRange: —
Pocketboolean

Pocket

boolean—Default: falseRange: —

Sponsored Pocket

boolean—Default: falseRange: —
Snippetsboolean

Snippets

boolean—Default: falseRange: —
Lockedboolean

Locked

boolean—Default: falseRange: —

Generative AI

dictConfigure generative AI featuresDefault: —Range: —
Enabledboolean

Enabled

booleanControls whether generative AI features are enabled by defaultDefault: falseRange: —
Chatbotboolean

ChatBot

booleanControls access to AI chatbots in the sidebarDefault: falseRange: —

Link Previews

booleanControls whether AI is used to generate link previewsDefault: falseRange: —
TabGroupsboolean

Tab Groups

booleanControls whether AI is used to suggest names and tabs for tab groupsDefault: falseRange: —
Lockedboolean

Locked

booleanPrevents the user from changing generative AI preferencesDefault: falseRange: —
dictConfigure the default homepage and how Firefox starts.Default: —Range: —
URLstring
stringOptional. Set the default home page.Default: —Range: —

Additional Homepages

arrayOptional. Set additional homepages.Default: —Range: —
string—Default: —Range: —
StartPagestring

Start Page

stringOptional. This preference sets what displays when Firefox starts. It can be the homepage, the previous session, or a blank page.Default: —Range: None (none), Homepage (homepage), Homepage (Locked) (homepage-locked), Previous Session (previous-session)
Lockedboolean
booleanIf true, prevents the user from changing homepage preferences.Default: falseRange: —

Show Home Button

booleanShow the home button on the toolbar.Default: falseRange: —
string
string—Default: —Range: —
NewTabPageboolean

New Tab Page

booleanEnable or disable the New Tab page.Default: —Range: —

No Default Bookmarks

booleanDisable the creation of default bookmarks.Default: —Range: —

Override First Run Page

stringOverride the first run page. If the value is blank, no first run page is displayed. Starting with Firefox 83, Firefox ESR 78.5, you can also specify multiple URLS separated by a vertical bar (|).Default: —Range: —

Override Post Update Page

stringOverride the upgrade page. If the value is blank, no upgrade page is displayed.Default: —Range: —

Picture-in-Picture

dictEnable or disable Picture-in-Picture.Default: —Range: —
Enabledboolean
boolean—Default: —Range: —
Lockedboolean
boolean—Default: —Range: —

Prompt for Download Location

booleanAsk where to save each file before downloading.Default: —Range: —

Requested Locales

arraySet the the list of requested locales for the application in order of preference. It will cause the corresponding language pack to become active.Default: —Range: —
actionstring

Action

stringActionDefault: ""Range: Acholi (ach), Afrikaans (af), Albanian (sq), Arabic (ar), Aragonese (an), Armenian (hy-AM), Assamese (as), Asturian (ast), Azerbaijani (az), Basque (eu), Belarusian (be), Bengali (Bangladesh) (bn-BD), Bengali (India) (bn-IN), Bosnian (bs), Breton (br), Bulgarian (bg), Burmese (my), Catalan (ca), Chinese (Simplified) (zh-CN), Chinese (Traditional) (zh-TW), Croatian (hr), Czech (cs), Danish (da), Dutch (nl), English (British) (en-GB), English (Canadian) (en-CA), English (South African) (en-ZA), English (US) (en-US), Esperanto (eo), Estonian (et), Finnish (fi), French (fr), Frisian (fy-NL), Fulah (ff), Gaelic (Scotland) (gd), Galician (gl), Georgian (ka), German (de), Greek (el), Guarani (gn), Gujarati (India) (gu-IN), Hebrew (he), Hindi (India) (hi-IN), Hungarian (hu), Icelandic (is), Indonesian (id), Interlingua (ia), Irish (ga-IE), Italian (it), Japanese (ja), Kabyle (kab), Kannada (kn), Kaqchikel (cak), Kazakh (kk), Khmer (km), Korean (ko), Latvian (lv), Ligurian (lij), Lithuanian (lt), Lower Sorbian (dsb), Macedonian (mk), Maithili (mai), Malay (ms), Malayalam (ml), Marathi (mr), Nepali (ne-NP), Norwegian (Bokmål) (nb-NO), Norwegian (Nynorsk) (nn-NO), Occitan (Lengadocian) (oc), Odia (or), Persian (fa), Polish (pl), Portuguese (Brazilian) (pt-BR), Portuguese (Portugal) (pt-PT), Punjabi (India) (pa-IN), Romanian (ro), Romansh (rm), Russian (ru), Serbian (sr), Sinhala (si), Slovak (sk), Slovenian (sl), Songhai (son), Spanish (Argentina) (es-AR), Spanish (Chile) (es-CL), Spanish (Mexico) (es-MX), Spanish (Spain) (es-ES), Swedish (sv-SE), Tamil (ta), Telugu (te), Thai (th), Turkish (tr), Ukrainian (uk), Upper Sorbian (hsb), Urdu (ur), Uzbek (uz), Vietnamese (vi), Welsh (cy), Xhosa (xh)

Sanitize On Shutdown (Selective)

dictClear data on shutdown. Choose from Cache, Cookies, Download History, Form & Search History, Browsing History, Active Logins, Site Preferences and Offline Website Data.Default: —Range: —
Cacheboolean
boolean—Default: falseRange: —
Cookiesboolean
boolean—Default: falseRange: —
Downloadsboolean
boolean—Default: falseRange: —
FormDataboolean

Form Data

boolean—Default: falseRange: —
Historyboolean
boolean—Default: falseRange: —
Sessionsboolean
boolean—Default: falseRange: —

Site Settings

boolean—Default: falseRange: —

Offline Apps

boolean—Default: falseRange: —
Lockedboolean
boolean—Default: falseRange: —

Search Engines

dictSet whether or not search bar is displayed.Default: —Range: —
Defaultstring
stringSet the default search engine. This policy is only available on the ESR.Default: —Range: —
booleanPrevent installing search engines from webpages. This policy is only available on the ESR.Default: —Range: —
Removearray
arrayHide built-in search engines. This policy is only available on the ESR.Default: —Range: —
string

Hidden Search Engines

string—Default: —Range: —
Addarray

Add Search Engines

arrayAdd new search engines. This policy is only available on the ESR.Default: —Range: —
dict

Search Engines

dict—Default: —Range: —
Namestring
stringName of the search engineDefault: —Range: —
string—Default: —Range: —
Methodstring
string—Default: —Range: GET, POST
IconURLstring
stringURL for the icon to useDefault: —Range: —
Aliasstring
stringkeyword to use for the engineDefault: —Range: —
stringDescription of the search engine.Default: —Range: —
PostDatastring
stringPOST data as name value pairs separated by '&'Default: —Range: —
stringSearch suggestions URL with {searchTerms} to substitute for the search term.Default: —Range: —
Encodingstring
stringThe query charset for the engine.Default: "UTF-8"Range: —

Enable Search Suggest

booleanEnable search suggestions.Default: —Range: —
dictConfigure default application handlers. This policy is based on the internal format of handlers.json. You can configure handlers based on a mime type (mimeTypes), a file's extension (extensions), or a protocol (schemes).Default: —Range: —

MIME Types

dictSpecify MIME types. More info here: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_typesDefault: —Range: —
{{key}}string

MIME Type

stringhttps://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_typesDefault: —Range: —
dict—Default: —Range: —
actionstring

Action

stringCan be either saveToDisk, useHelperApp, useSystemDefault.Default: —Range: Save to Disk (saveToDisk), Use Helper App (useHelperApp), Use System Default (useSystemDefault)
askboolean

Ask

booleanIf true, the user is asked if what they want to do with the file. If false, the action is taken without user intervention.Default: —Range: —

Schemes

dict—Default: —Range: —
actionstring

Action

stringCan be either saveToDisk, useHelperApp, useSystemDefault.Default: —Range: Save to Disk (saveToDisk), Use Helper App (useHelperApp), Use System Default (useSystemDefault)
askboolean

Ask

booleanIf true, the user is asked if what they want to do with the file. If false, the action is taken without user intervention.Default: —Range: —

Handlers

arrayAn 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.Default: —Range: —
dict

MIME Type

dict—Default: —Range: —
namestring

Name

stringThe display name of the handler (might not be used).Default: —Range: —
pathstring

Path

stringThe native path to the executable to be used.Default: —Range: —

URI Template

stringA url to a web based application handler. The URL must be https and contain a %s to be used for substitution.Default: —Range: —

Extensions

dict—Default: —Range: —
actionstring

Action

stringCan be either saveToDisk, useHelperApp, useSystemDefault.Default: —Range: Save to Disk (saveToDisk), Use Helper App (useHelperApp), Use System Default (useSystemDefault)
askboolean

Ask

booleanIf true, the user is asked if what they want to do with the file. If false, the action is taken without user intervention.Default: —Range: —

Handlers

arrayAn 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.Default: —Range: —
dict
dict—Default: —Range: —
namestring

Name

stringThe display name of the handler (might not be used).Default: —Range: —
pathstring

Path

stringThe native path to the executable to be used.Default: —Range: —

URI Template

stringA url to a web based application handler. The URL must be https and contain a %s to be used for substitution.Default: —Range: —

Disabled Ciphers

dictDisable specific cryptographic ciphers. 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.Default: —Range: —
boolean—Default: —Range: —
boolean—Default: —Range: —
boolean—Default: —Range: —
boolean—Default: —Range: —
boolean—Default: —Range: —
boolean—Default: —Range: —
boolean—Default: —Range: —
boolean—Default: —Range: —
boolean—Default: —Range: —
boolean—Default: —Range: —
boolean—Default: —Range: —

DNS over HTTPS

dictConfigure DNS over HTTPS.Default: —Range: —
Enabledboolean
required
booleanEnable DNS over HTTPS.Default: falseRange: —

Provider URL

stringURL to an alternative DNS over HTTPS provider.Default: —Range: —
Lockedboolean
booleanIf this is true, DNS over HTTPS preferences cannot be changed.Default: falseRange: —

Excluded Domains

arrayList of excluded domains from DNS over HTTPS.Default: —Range: —
string

Excluded Domains

string—Default: —Range: —
Proxydict
dictConfigure proxy settings. These settings correspond to the connection settings in Firefox preferences. To specify ports, append them to the hostnames with a colon (:).Default: —Range: —
Modestring
required
stringIf this preference is enabled, you will be setting the proxy mode.Default: —Range: No Proxy (none), Use system proxy settings (system), Manual proxy configuration (manual), Auto-detect proxy settings (autoDetect), Automatic proxy configuration (autoConfig)
Lockedboolean
booleanIf this preference is enabled, Proxy preferences cannot be changed.Default: falseRange: —
AutoLoginboolean
booleanIf this preference is enabled, do not prompt for authentication if password is saved.Default: falseRange: —
booleanIf this preference is enabled, you will use Proxy DNS when using SOCKS v5.Default: falseRange: —
HTTPProxystring

HTTP Proxy

stringHTTP Proxy URL.Default: —Range: —
booleanIf this preference is enabled, use the HTTP proxy server for all protocols.Default: falseRange: —
SSLProxystring

SSL Proxy

stringSSL Proxy URL.Default: —Range: —
FTPProxystring

FTP Proxy

stringFTP Proxy URL.Default: —Range: —

SOCKS Proxy

stringSOCKS Proxy URL.Default: —Range: —

SOCKS Version

stringSelect SOCKS Version.Default: —Range: 4 (4), 5 (5)

No Proxy For

stringProxy bypass URLs.Default: "localhost, 127.0.0.1"Range: —

Automatic Proxy Configuration URL

stringProxy bypass URLs.Default: —Range: —

SSLVersionMin

string—Default: —Range: TLS 1.0 (tls1), TLS 1.1 (tls1.1), TLS 1.2 (tls1.2), TLS 1.3 (tls1.3)

SSLVersionMax

string—Default: —Range: TLS 1.0 (tls1), TLS 1.1 (tls1.1), TLS 1.2 (tls1.2), TLS 1.3 (tls1.3)

Network Prediction

booleanEnable or disable network prediction (DNS prefetching).Default: —Range: —
dictConfigure cookie preferences.Default: —Range: —
Allowarray

Allow

arrayA list of origins (not domains) where cookies are always allowed.Default: —Range: —
URLstring

URL

string—Default: —Range: —

Allow Session

arrayA list of origins (not domains) where cookies are only allowed for the current session.Default: —Range: —
URLstring

URL

string—Default: —Range: —
Blockarray

Block

arrayA list of origins (not domains) where cookies are always blocked.Default: —Range: —
URLstring

URL

string—Default: —Range: —
Behaviorstring
stringThis has been added replacing the existing options Default, AcceptThirdParty, and RejectTracker.Default: —Range: accept, reject-foreign, reject, limit-foreign, reject-tracker, reject-tracker-and-partition-foreign

Behavior: Private Browsing

string—Default: —Range: accept, reject-foreign, reject, limit-foreign, reject-tracker, reject-tracker-and-partition-foreign
Defaultboolean
booleanThis sets the default value for "Accept cookies from websites".Default: trueRange: —
stringThis sets the default value for "Accept third-party cookies".Default: —Range: always (always), never (never), from-visited (from-visited)
booleanThis determines when cookies expire.Default: falseRange: —
booleanOnly reject trackers.Default: falseRange: —
Lockedboolean
booleanIf this is true, cookies preferences cannot be changed.Default: falseRange: —

Disable Form History

booleanTurn off saving information on web forms and the search bar.Default: trueRange: —

Disable Password Reveal

booleanDo not allow passwords to be shown in saved loginsDefault: trueRange: —

Disable Telemetry

booleanPrevent the upload of telemetry data.Default: trueRange: —

Enable Tracking Protection

dictConfigure tracking protection. 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.Default: {"Locked":true,"Value":true}Range: —
Valueboolean
booleanIf Value is set to false, tracking protection is disabled and locked in both the regular browser and private browsing. If Value is set to true, tracking protection is enabled by default in both the regular browser and private browsing.Default: falseRange: —
Lockedboolean
booleanIf this is true, Tracking Protection preferences cannot be changed.Default: falseRange: —
booleanIf Cryptomining is set to true, cryptomining scripts on websites are blocked.Default: falseRange: —
booleanIf Fingerprinting is set to true, fingerprinting scripts on websites are blocked.Default: falseRange: —

Flash Plugin Permissions

dictConfigure the default Flash plugin policy as well as origins for which Flash is allowed.Default: —Range: —
Allowarray

Allowed Domains

arrayIf this preference is enabled, sites on the allow list do not override Flash being completely disabled. Flash is activated by default for the domains indicated unless Flash is completely disabled. If a top level domain is specified (http://example.org), Flash is allowed for all subdomains as well.Default: —Range: —
string—Default: —Range: —
Blockarray

Blocked Domains

arrayIf this preference is enabled, Flash is blocked for the domains indicated. If a top level domain is specified (http://example.org), Flash is blocked from all subdomains as well.Default: —Range: —
string—Default: —Range: —
Defaultboolean
booleanIf this is true, Flash preferences cannot be changed. If this is false, Flash is never activated on websites even if they are in the specified in the Allow list.Default: falseRange: —
Lockedboolean
booleanIf this is true, Flash preferences cannot be changed.Default: falseRange: —

Install Add-ons Permissions

dictConfigure the default extension install policy as well as origins for extension installs are allowed.Default: —Range: —
Allowarray

Allowed Domains

arrayIf this preference is enabled, add-ons are always allowed for the domains indicated unless add-on install is disabled. If a top level domain is specified (http://example.org), add-ons are allowed for all subdomains as well.Default: —Range: —
string—Default: —Range: —
Defaultboolean
booleanIf this is set to false, add-ons cannot be installed by the user.Default: falseRange: —

Offer To Save Logins

booleanControl whether or not Firefox offers to save passwords.Default: falseRange: —

Offer To Save Logins Default

booleanSets the default value of signon.rememberSignons without locking it.Default: falseRange: —

Enable Password Manager

booleanRemove access to the password manager via preferences and blocks about:logins on Firefox 70.Default: falseRange: —
dictSet permissions associated with camera, microphone, location, notifications, and autoplay.Default: —Range: —
Cameradict

Camera Permissions

dictThis preference allows you to change the camera permissions.Default: —Range: —
Allowarray
arrayIf this preference is enabled, access to the camera is always allowed for the domains indicated. If this preference is disabled or not configured, the default camera preference is followed.Default: —Range: —
string—Default: —Range: —
Blockarray
arrayIf this preference is enabled, access to the camera is blocked for the domains indicated. If this preference is disabled or not configured, access to the camera is not blocked by default.Default: —Range: —
string—Default: —Range: —

Block New Requests

booleanIf this preference is enabled, sites that are not in the Allow preference will not be allowed to ask permission to access the camera. If this preference is disabled or not configured, any site that is not in the Block preference can ask permission to access the camera.Default: trueRange: —
Lockedboolean
booleanIf this preference is enabled, camera preferences cannot be changed by the user. If this preference is disabled or not configured, the user can change their camera preferences.Default: falseRange: —

Microphone Permissions

dictThis preference allows you to change the microphone permissions.Default: —Range: —
Allowarray
arrayIf this preference is enabled, access to the microphone is always allowed for the domains indicated. If this preference is disabled or not configured, the default microphone preference is followed.Default: —Range: —
string—Default: —Range: —
Blockarray
arrayIf this preference is enabled, access to the microphone is blocked for the domains indicated. If this preference is disabled or not configured, access to the microphone is not blocked by default.Default: —Range: —
string—Default: —Range: —

Block New Requests

booleanIf this preference is enabled, sites that are not in the Allow preference will not be allowed to ask permission to access the microphone. If this preference is disabled or not configured, any site that is not in the Block preference can ask permission to access the microphone.Default: trueRange: —
Lockedboolean
booleanIf this preference is enabled, microphone preferences cannot be changed by the user. If this preference is disabled or not configured, the user can change their microphone preferences.Default: falseRange: —

Location Permissions

dictThis preference allows you to change the location permissions.Default: —Range: —
Allowarray
arrayIf this preference is enabled, access to location is always allowed for the domains indicated. If this preference is disabled or not configured, the default location preference is followed.Default: —Range: —
string—Default: —Range: —
Blockarray
arrayIf this preference is enabled, access to location is blocked for the domains indicated. If this preference is disabled or not configured, access to location is not blocked by default.Default: —Range: —
string—Default: —Range: —

Block New Requests

booleanIf this preference is enabled, sites that are not in the Allow preference will not be allowed to ask permission to access location. If this preference is disabled or not configured, any site that is not in the Block preference can ask permission to access the location.Default: trueRange: —
Lockedboolean
booleanIf this preference is enabled, location preferences cannot be changed by the user. If this preference is disabled or not configured, the user can change their location preferences.Default: falseRange: —

Notifications Permissions

dictThis preference allows you to change the notifications permissions.Default: —Range: —
Allowarray
arrayIf this preference is enabled, notifications can always be sent for the domains indicated. If this preference is disabled or not configured, the default nofication preference is followed.Default: —Range: —
string—Default: —Range: —
Blockarray
arrayIf this preference is enabled, notifications are always blocked for the domains indicated. If this preference is disabled or not configured, notifications are not blocked by default.Default: —Range: —
string—Default: —Range: —

Block New Requests

booleanIf this preference is enabled, sites that are not in the Allow preference will not be allowed to ask permission to send notifications. If this preference is disabled or not configured, any site that is not in the Block preference can ask permission to send notifications.Default: trueRange: —
Lockedboolean
booleanIf this preference is enabled, notification preferences cannot be changed by the user. If this preference is disabled or not configured, the user can change their notification preferences.Default: falseRange: —

Autoplay Permissions

dictThis preference allows you to change the autoplay permissions.Default: —Range: —
Allowarray
arrayIf this preference is enabled, autoplay can always be enabled for the domains indicated. If this preference is disabled or not configured, the default autoplay preference is followed.Default: —Range: —
string—Default: —Range: —
Blockarray
arrayIf this preference is enabled, autoplay are always blocked for the domains indicated. If this preference is disabled or not configured, autoplay is not blocked by default.Default: —Range: —
string—Default: —Range: —
Defaultstring

Default Autoplay Behavior

stringConfigures the default Autoplay behavior.Default: —Range: Allow Audio & Video (allow-audio-video), Block Audio (block-audio), Block Audio & Video (block-audio-video)
Lockedboolean

Locked

booleanIf this preference is enabled, autoplay preferences cannot be changed by the user. If this preference is disabled or not configured, the user can change their autoplay preferences.Default: falseRange: —

Virutal Reality Permissions

dictThis preference allows you to change the virtual reality permissions.Default: —Range: —
Allowarray
arrayIf this preference is enabled, access to virtual reality is always allowed for the domains indicated. If this preference is disabled or not configured, the default virtual reality preference is followed.Default: —Range: —
string—Default: —Range: —
Blockarray
arrayIf this preference is enabled, access to virtual reality is blocked for the domains indicated. If this preference is disabled or not configured, access to the virtual reality is not blocked by default.Default: —Range: —
string—Default: —Range: —

Block New Requests

booleanIf this preference is enabled, sites that are not in the Allow preference will not be allowed to ask permission to access virtual reality. If this preference is disabled or not configured, any site that is not in the Block preference can ask permission to access virtual reality.Default: trueRange: —
Lockedboolean
booleanIf this preference is enabled, virtual reality preferences cannot be changed by the user. If this preference is disabled or not configured, the user can change their virtual reality preferences.Default: falseRange: —

Popup Blocking

dictConfigure the default pop-up window policy as well as origins for which pop-up windows are allowed.Default: —Range: —
Allowarray

Allowed Domains

arraySpecify the domains for which pop-up windows are always allowed. If a top level domain is specified (http://example.org), pop-up windows are allowed for all subdomains as well.Default: —Range: —
string—Default: —Range: —
Defaultboolean
booleanIf this is false, pop-up windows are allowed by default.Default: trueRange: —
Lockedboolean
booleanIf this is true, pop-up blocking preferences cannot be changed.Default: falseRange: —
dictTrust certificates that have been added to the operating system certificate store by a user or administrator in the macOS Keychain.Default: —Range: —
booleanIf this preference is enabled, Firefox will read certificates from the macOS keychain. If this preference is disabled or not configured, Firefox will not read certificates from the macOS keychain.Default: trueRange: —
Installarray

Install

arrayIf this preference is enabled, Firefox will install the listed certificates. It will look in /Library/Application Support/Mozilla/Certificates and ~/Library/Application Support/Mozilla/Certificates. If this preference is disabled or not configured, Firefox will not install additional certificates. Starting in Firefox 65, you can specify a fully qualified path (e.g. /Library/Company/cer1.der). If Firefox does not find something at your fully qualified path, it will search the default directories.Default: —Range: —
string—Default: —Range: —

Disable Security Bypass

dictPrevent the user from bypassing security in certain cases.Default: —Range: —
booleanPrevents adding an exception when an invalid certificate is shown. If this preference is enabled, the "Add Exception" button is not available when a certificate is invalid. This prevents the user from overriding the certificate error. If this preference is disabled or not configured, certificate errors can be overridden.Default: trueRange: —
booleanPrevents selecting "ignore the risk" and visiting a harmful site anyway. If this preference is enabled, a user cannot bypass the warning and visit a harmful site. If this preference is disabled or not configured, a user can choose to visit a harmful site.Default: trueRange: —
dictInstall PKCS #11 modules.Default: {"NAME_OF_DEVICE":"PATH_TO_LIBRARY_FOR_DEVICE"}Range: —
{{key}}string

Device Name

string—Default: —Range: —
{{value}}string

Library Path

string—Default: —Range: —

Search Engine Installs from Websites

dictPrevent installing search engines from webpages.Default: —Range: —
WhatsNewboolean

What's New

booleanIf enabled, remove the "What's New" icon and menuitem.Default: —Range: —

Extension Recomendations

booleanIf enabled, don't recommend extensions.Default: —Range: —

Feature Recommendations

booleanIf enabled, don't recommend browser features.Default: —Range: —

Skip Onboarding

booleanIf enabled, don't show onboarding messages on the new tab page.Default: —Range: —

URL Bar Interventions

booleanIf enabled, don't offer Firefox specific suggestions in the URL bar.Default: —Range: —

Legacy SameSite Cookie Behavior Enabled

booleanEnable default legacy SameSite cookie behavior setting.Default: —Range: —

Legacy SameSite Cookie Behavior Enabled for Domain List

arrayRevert to legacy SameSite behavior for cookies on specified sites.Default: —Range: —
string

Domain

string—Default: —Range: —
dictBlock 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. http/https addresses are supported as well as local file:// URLs. The arrays are limited to 1000 entries each.Default: —Range: —
Blockarray

Block

required
arrayIf this preference is enabled, you can specify match patterns that indicate sites to be blocked. The match patterns are documented at https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Match_patterns. Only http/https addresses are supported at the moment. There is a 1000 entry limit. If this preference is disabled or not configured, no websites are blocked.Default: —Range: —
Blockstring

Blocked Sites

string—Default: —Range: —

Exceptions

arrayIf this preference is enabled, and the website filter is enabled, you can specify match patterns for sites you do not want to block. The match patterns are documented at https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Match_patterns. Only http/https addresses are supported at the moment. There is a 1000 entry limit. If this preference is disabled or not configured, there are no exceptions to the website filter.Default: —Range: —

Exceptions To Website Filter

string—Default: —Range: —

Allowed Domains for Apps

stringComma-separated list of domains allowed to access Google Workspace. This policy is based on the Chrome policy of the same name. 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.Default: —Range: —

Auto Launch Protocols from Origins

arrayComma-separated list of domains allowed to access Google Workspace. This policy is based on the Chrome policy of the same name. 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.Default: —Range: —
dict
dict—Default: —Range: —
protocolstring

Protocol

stringThe protocol to allow for specified URLs.Default: —Range: —

Allowed Origins

arrayThe protocol to allow for specified URLs.Default: —Range: —
string

URL

string—Default: —Range: —

Captive Portal

booleanEnable or disable the detection of captive portals.Default: —Range: —

Preferences

dictSet and lock certain preferences.Default: —Range: —

accessibility.force_disabled

integerIf set to 1, platform accessibility is disabled.Default: 0Range: Not Disabled (0), Disabled (1)

app.update.auto

booleanIf false, Firefox doesn't automatically install update.Default: trueRange: —

browser.bookmarks.autoExportHTML

booleanIf true, bookmarks are exported on shutdown.Default: falseRange: —

browser.bookmarks.file

string If set, the name of the file where bookmarks are exported and imported.Default: —Range: —

browser.bookmarks.restore_default_bookmarks

booleanIf true, bookmarks are restored to their defaults.Default: falseRange: —

browser.cache.disk.enable

booleanIf false, don't store cache on the hard drive.Default: trueRange: —

browser.cache.disk.parent_directory

stringIf set, changes the location of the disk cache.Default: "Profile temporary directory"Range: —

browser.fixup.dns_first_for_single_words

booleanIf true, single words are sent to DNS, not directly to search.Default: falseRange: —

browser.newtabpage.activity-stream.default.sites

arrayIf set, a list of URLs to use as the default top sites on the new tab page.Default: —Range: —
string

Sites

string—Default: —Range: —

browser.places.importBookmarksHTML

booleanIf true, bookmarks are always imported on startup.Default: —Range: —

browser.safebrowsing.malware.enabled

booleanIf false, malware protection is not enabled (Not recommended)Default: trueRange: —

browser.safebrowsing.phishing.enabled

booleanIf false, phishing protection is not enabled (Not recommended)Default: trueRange: —

browser.search.update

booleanIf false, updates for search engines are not checked.Default: trueRange: —

browser.slowStartup.notificationDisabled

boolean If true, a notification isn't shown if startup is slow.Default: falseRange: —

browser.tabs.warnOnClose

booleanIf false, there is no warning when the browser is closed.Default: trueRange: —

browser.taskbar.previews.enable

booleanIf true, tab previews are shown in the Windows taskbar.Default: falseRange: —

browser.urlbar.suggest.bookmark

booleanIf false, bookmarks aren't suggested when typing in the URL bar.Default: trueRange: —

browser.urlbar.suggest.history

booleanIf false, history isn't suggested when typing in the URL bar.Default: trueRange: —

browser.urlbar.suggest.openpage

booleanIf false, open tabs aren't suggested when typing in the URL bar.Default: trueRange: —

datareporting.policy.dataSubmissionPolicyBypassNotification

booleanIf true, don't show the privacy policy tab on first run.Default: falseRange: —

dom.allow_scripts_to_close_windows

booleanIf false, web page can close windows.Default: trueRange: —

dom.disable_window_flip

booleanIf false, web pages can focus and activate windows.Default: trueRange: —

dom.disable_window_move_resize

booleanIf true, web pages can't move or resize windows.Default: falseRange: —

dom.event.contextmenu.enabled

booleanIf false, web pages can't override context menus.Default: trueRange: —

dom.keyboardevent.keypress.hack.dispatch_non_printable_keys.addl

stringSee https://support.mozilla.org/en-US/kb/dom-events-changes-introduced-firefox-66Default: ""Range: —

dom.keyboardevent.keypress.hack.use_legacy_keycode_and_charcode.addl

stringSee https://support.mozilla.org/en-US/kb/dom-events-changes-introduced-firefox-66Default: ""Range: —

extensions.blocklist.enabled

booleanIf false, the extensions blocklist is not used (Not recommended)Default: trueRange: —

extensions.getAddons.showPane

booleanIf false, the Recommendations tab is not displayed in the Add-ons Manager.Default: falseRange: —

extensions.htmlaboutaddons.recommendations.enabled

booleanIf false, recommendations are not shown on the Extensions tab in the Add-ons Manager.Default: trueRange: —

geo.enabled

booleanIf false, the geolocation API is disabled.Default: trueRange: —

intl.accept_languages

stringIf set, preferred language for web pages.Default: —Range: —

media.eme.enabled

booleanIf false, Encrypted Media Extensions are not enabled.Default: trueRange: —

media.gmp-gmpopenh264.enabled

booleanIf false, the OpenH264 plugin is not downloaded.Default: trueRange: —

media.gmp-widevinecdm.enabled

booleanIf false, the Widevine plugin is not downloaded.Default: trueRange: —

media.peerconnection.enabled

booleanIf false, WebRTC is disabledDefault: trueRange: —

media.peerconnection.ice.obfuscate_host_addresses.blocklist

arrayIf set, a list of domains for which mDNS hostname obfuscation is disabled.Default: —Range: —
string

Domains

string—Default: —Range: —

network.dns.disableIPv6

booleanIf true, IPv6 DNS lokoups are disabled.Default: falseRange: —

network.IDN_show_punycode

booleanIf true, display the punycode version of internationalized domain names.Default: falseRange: —

places.history.enabled

booleanIf false, history is not enabled.Default: trueRange: —

print.save_print_settings

booleanIf false, print settings are not saved between jobs.Default: trueRange: —

security.default_personal_cert

stringIf set to "Select Automatically", Firefox automatically chooses the default personal certificate. Other possible option is "Ask Every Time".Default: "Ask Every Time"Range: Ask Every Time, Select Automatically

security.mixed_content.block_active_content

booleanIf false, mixed active content (HTTP and HTTPS) is not blocked.Default: trueRange: —

security.osclientcerts.autoload

booleanIf true, client certificates are loaded from the operating system certificate store.Default: falseRange: —

security.ssl.errorReporting.enabled

booleanIf false, SSL errors cannot be sent to Mozilla.Default: trueRange: —

security.tls.hello_downgrade_check

booleanIf false, the TLS 1.3 downgrade check is disabled.Default: trueRange: —
booleanIf false, TLS early data is turned off.Default: trueRange: —
booleanIf true, browser will accept TLS 1.0. and TLS 1.1.Default: falseRange: —

widget.content.gtk-theme-override

stringIf set, overrides the GTK theme for widgets.Default: —Range: —

Support Menu

dictAdds a menuitem to the help menu for specifying support information.Default: —Range: —
Titlestring

Title

string—Default: —Range: —
URLstring

URL

string—Default: —Range: —
AccessKeystring

AccessKey

string—Default: —Range: —

Allow single sign-on for Microsoft Entra accounts on macOS

booleanIf this policy is set to true, Firefox will use credentials stored in the Company Portal to sign in to Microsoft Entra accounts. Affects `network.http.microsoft-entra-sso.enabled`.Default: falseRange: —