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)

KeyTypeTitle
EnterprisePoliciesEnabledrequired

Enable policy support on macOS.

Default: true

booleanEnable Enterprise Policies
PFC_SegmentedControl_0required
string—
General_SegmentedControlrequired
string—
Privacy_SegmentedControlrequired
string—
Security_SegmentedControlrequired
string—
BackgroundAppUpdate

Enable 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.

booleanBackground App Update
AppAutoUpdate

Enable or disable automatic application update.

booleanFirefox Auto Update
AppUpdateURL

Change the URL for application update.

stringApplication Update URL
Authentication

Configure sites that support integrated authentication.

dict—
SPNEGO

If 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.

arraySPNEGO
Domain
string—
Delegated

If 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_authentication

arrayDelegated
Domain
string—
NTLM

If 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.

arrayMicrosoft Challenge/Response (NTLM)
Domain
string—
AllowNonFQDN

If 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.

dictAllow Non-FQDN
NTLMrequired

Default: true

boolean—
SPNEGOrequired

Default: true

boolean—
AllowProxies

If 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.

dictAllow Proxies
NTLMrequired

Default: true

boolean—
SPNEGOrequired

Default: true

boolean—
Locked
booleanLocked (Authentication)
PrivateBrowsing

Enables integrated authentication in prviate browsing

booleanPrivate Browsing
BlockAboutAddons

Block access to the Add-ons Manager (about:addons).

booleanBlock about:addons page
BlockAboutConfig

Block access to about:config.

booleanBlock about:config page
BlockAboutProfiles

Block access to About Profiles (about:profiles).

booleanBlock about:profiles page
BlockAboutSupport

Block access to Troubleshooting Information (about:support).

booleanBlock about:support page
Bookmarks

Add bookmarks in either the bookmarks toolbar or menu.

array—
Bookmarks
dict—
Titlerequired

Bookmark Title

string—
URLrequired

Full URL to be bookmarked (e.g. https://www.example.org/)

string—
Placement

Place bookmark in either the Bookmark menu or Bookmark Toolbar.

Range: toolbar (toolbar), menu (menu)

string—
Favicon

URL to icon file to display on bookmark (e.g. https://www.example.org/favicon.ico)

string—
Folder

Folder 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.

string—
DefaultDownloadDirectory

Set the default download directory.

stringDefault Download Directory
DisableAppUpdate

Turn off application updates.

booleanDisable Application Update
DisableBuiltinPDFViewer

Disable the built in PDF viewer. PDF files are downloaded and sent externally.

booleanDisable Built-in PDF Viewer
PDFjs

Disable or configure PDF.js, the built-in PDF viewer.

dictPDF.js
Enabled

If Enabled is set to false, the built-in PDF viewer is disabled.

boolean—
EnablePermissions

If EnablePermissions is set to true, the built-in PDF viewer will honor document permissions like preventing the copying of text.

boolean—
DisableDeveloperTools

Remove access to all developer tools.

booleanDisable Developer Tools
DisableFeedbackCommands

Disable the menus for reporting sites (Submit Feedback, Report Deceptive Site).

booleanDisable Feedback Commands
DisableFirefoxAccounts

Disable Firefox Accounts integration (Sync).

booleanDisable Firefox Accounts / Sync
DisableFirefoxScreenshots

Remove access to Firefox Screenshots.

booleanDisable Firefox Screenshots
DisableFirefoxStudies

Disable Firefox studies (Shield).

booleanDisable Firefox Studies (Shield)
DisableForgetButton

Disable the "Forget" button.

booleanDisable Forget Button
DisableMasterPasswordCreation

Remove the master password functionality. If this preference is set to true, the master password functionality is removed.

booleanDisable Master Password Creation
PrimaryPassword

Require or prevent using a primary (formerly master) password. If this value is true, a primary password is required.

booleanEnable Primary Password
DisablePocket

Remove Pocket in the Firefox UI.

booleanDisable Pocket
DisablePrivateBrowsing

Remove access to private browsing.

booleanDisable Private Browsing
DisableProfileImport

Disables the "Import data from another browser" option in the bookmarks window.

booleanDisable Profile Import
DisableProfileRefresh

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.

booleanDisable Profile Refresh
DisableSafeMode

Disable safe mode within the browser.

booleanDisable Safe Mode
DisableSetDesktopBackground

This preference removes the "Set As Desktop Background..." menu item when right clicking on an image.

booleanDisable Set Desktop Background
DisplayMenuBar

Set the initial state of the menubar. A user can still hide it and it will stay hidden.

booleanDisplay Menu Bar
DisableSystemAddonUpdate

Prevent system add-ons from being installed or update.

booleanDisable System Add-on Update
DisplayBookmarksToolbar

Set the initial state of the bookmarks toolbar. A user can still hide it and it will stay hidden.

booleanDisplay Bookmarks Toolbar
DontCheckDefaultBrowser

Don't check if Firefox is the default browser at startup.

booleanDo Not Check Default Browser
DownloadDirectory

Set and lock the download directory.

stringDownload Directory
Extensions

Control 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.

dict—
Install

A list of URLs or native paths for extensions to be installed.

arrayInstall
Install
stringInstall
Uninstall

A list of extension IDs that should be uninstalled if found.

arrayUninstall
Uninstall
stringExtension ID To Uninstall
Locked

A list of extension IDs that the user cannot disable or uninstall.

arrayLocked
Locked
stringExtension ID To Lock
ExtensionSettings

Manage 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.

dict—
{{key}}
stringExtension ID
{{value}}
dict—
installation_mode

Maps to a string indicating the installation mode for the extension.

Range: Allowed (default behavior) (allowed), Blocked (blocked), Force Installed (force_installed), Normal Installed (normal_installed)

stringInstallation Mode
install_url

Maps 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.

stringInstall URL
install_sources

Each item in this list is an extension-style match pattern.

arrayInstall Sources
string—
allowed_types

This setting allowlists the allowed types of extension/apps that can be installed in Firefox.

arrayAllowed Types

Range: extension, theme, dictionary, langpack

string—
blocked_install_message

This maps to a string specifying the error message to display to users if they're blocked from installing an extension.

string—
restricted_domains

An array of domains on which content scripts can't be run.

arrayRestricted Domains
stringRestricted Domain
updates_disabled

Indicates whether or not to disable automatic updates for an individual extension.

booleanDisable Updates
ExtensionUpdate
booleanExtension Update
3rdparty

Configure third party components.

dict3rd Party Configuration
Extensions

Configure third party extensions. Keys in this dictionary specify IDs of extensions to configure, and values are dictionaries containing each third party extension configuration.

dict3rd Party Extension Configuration
{{key}}
stringExtension ID
{{value}}
dictExtension Configuration
EncryptedMediaExtensions

Enable or disable Encrypted Media Extensions and optionally lock it.

dictEncrypted Media Extensions
Enabled

If Enabled is set to false, encrypted media extensions (like Widevine) are not downloaded by Firefox unless the user consents to installing them.

boolean—
Locked

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.

boolean—
HardwareAcceleration

Control hardware acceleration.

booleanHardware Acceleration
FirefoxHome

Customize the Firefox Home page.

dictFirefoxHome
Search

Default: false

booleanSearch
TopSites

Default: false

booleanTopSites
SponsoredTopSites

Default: false

booleanSponsored Top Sites
Highlights

Default: false

booleanHighlights
Pocket

Default: false

booleanPocket
SponsoredPocket

Default: false

booleanSponsored Pocket
Snippets

Default: false

booleanSnippets
Locked

Default: false

booleanLocked
GenerativeAI

Configure generative AI features

dictGenerative AI
Enabled

Controls whether generative AI features are enabled by default

Default: false

booleanEnabled
Chatbot

Controls access to AI chatbots in the sidebar

Default: false

booleanChatBot
LinkPreviews

Controls whether AI is used to generate link previews

Default: false

booleanLink Previews
TabGroups

Controls whether AI is used to suggest names and tabs for tab groups

Default: false

booleanTab Groups
Locked

Prevents the user from changing generative AI preferences

Default: false

booleanLocked
Homepage

Configure the default homepage and how Firefox starts.

dict—
URL

Optional. Set the default home page.

string—
Additional

Optional. Set additional homepages.

arrayAdditional Homepages
Additional
string—
StartPage

Optional. This preference sets what displays when Firefox starts. It can be the homepage, the previous session, or a blank page.

Range: None (none), Homepage (homepage), Homepage (Locked) (homepage-locked), Previous Session (previous-session)

stringStart Page
Locked

If true, prevents the user from changing homepage preferences.

Default: false

boolean—
ShowHomeButton

Show the home button on the toolbar.

Default: false

booleanShow Home Button
LocalFileLinks

Enable linking to local files by origin

arrayLocal File Links
string—
NewTabPage

Enable or disable the New Tab page.

booleanNew Tab Page
NoDefaultBookmarks

Disable the creation of default bookmarks.

booleanNo Default Bookmarks
OverrideFirstRunPage

Override 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 (|).

stringOverride First Run Page
OverridePostUpdatePage

Override the upgrade page. If the value is blank, no upgrade page is displayed.

stringOverride Post Update Page
PictureInPicture

Enable or disable Picture-in-Picture.

dictPicture-in-Picture
Enabled
boolean—
Locked
boolean—
PromptForDownloadLocation

Ask where to save each file before downloading.

booleanPrompt for Download Location
RequestedLocales

Set the the list of requested locales for the application in order of preference. It will cause the corresponding language pack to become active.

arrayRequested Locales
action

Action

Default: ""

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)

stringAction
SanitizeOnShutdown

Clear data on shutdown. Choose from Cache, Cookies, Download History, Form & Search History, Browsing History, Active Logins, Site Preferences and Offline Website Data.

dictSanitize On Shutdown (Selective)
Cache

Default: false

boolean—
Cookies

Default: false

boolean—
Downloads

Default: false

boolean—
FormData

Default: false

booleanForm Data
History

Default: false

boolean—
Sessions

Default: false

boolean—
SiteSettings

Default: false

booleanSite Settings
OfflineApps

Default: false

booleanOffline Apps
Locked

Default: false

boolean—
SearchBar

Set whether or not search bar is displayed.

Default: "separate"

Range: Separate (separate), Unified (unified)

stringSearch Bar
SearchEngines

Set whether or not search bar is displayed.

dictSearch Engines
Default

Set the default search engine. This policy is only available on the ESR.

string—
PreventInstalls

Prevent installing search engines from webpages. This policy is only available on the ESR.

boolean—
Remove

Hide built-in search engines. This policy is only available on the ESR.

array—
stringHidden Search Engines
Add

Add new search engines. This policy is only available on the ESR.

arrayAdd Search Engines
dictSearch Engines
Name

Name of the search engine

string—
URLTemplate
string—
Method

Range: GET, POST

string—
IconURL

URL for the icon to use

string—
Alias

keyword to use for the engine

string—
Description

Description of the search engine.

string—
PostData

POST data as name value pairs separated by '&'

string—
SuggestURLTemplate

Search suggestions URL with {searchTerms} to substitute for the search term.

string—
Encoding

The query charset for the engine.

Default: "UTF-8"

string—
SearchSuggestEnabled

Enable search suggestions.

booleanEnable Search Suggest
Handlers

Configure 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).

dict—
mimeTypes

Specify MIME types. More info here: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types

dictMIME Types
{{key}}

https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types

stringMIME Type
{{value}}
dict—
action

Can be either saveToDisk, useHelperApp, useSystemDefault.

Range: Save to Disk (saveToDisk), Use Helper App (useHelperApp), Use System Default (useSystemDefault)

stringAction
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.

booleanAsk
schemes
dictSchemes
action

Can be either saveToDisk, useHelperApp, useSystemDefault.

Range: Save to Disk (saveToDisk), Use Helper App (useHelperApp), Use System Default (useSystemDefault)

stringAction
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.

booleanAsk
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.

arrayHandlers
dictMIME Type
name

The display name of the handler (might not be used).

stringName
path

The native path to the executable to be used.

stringPath
uriTemplate

A url to a web based application handler. The URL must be https and contain a %s to be used for substitution.

stringURI Template
extensions
dictExtensions
action

Can be either saveToDisk, useHelperApp, useSystemDefault.

Range: Save to Disk (saveToDisk), Use Helper App (useHelperApp), Use System Default (useSystemDefault)

stringAction
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.

booleanAsk
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.

arrayHandlers
dict—
name

The display name of the handler (might not be used).

stringName
path

The native path to the executable to be used.

stringPath
uriTemplate

A url to a web based application handler. The URL must be https and contain a %s to be used for substitution.

stringURI Template
DisabledCiphers

Disable 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.

dictDisabled Ciphers
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
boolean—
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
boolean—
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
boolean—
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
boolean—
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
boolean—
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
boolean—
TLS_RSA_WITH_AES_128_CBC_SHA
boolean—
TLS_RSA_WITH_AES_256_CBC_SHA
boolean—
TLS_RSA_WITH_AES_128_GCM_SHA256
boolean—
TLS_RSA_WITH_AES_256_GCM_SHA384
boolean—
TLS_RSA_WITH_3DES_EDE_CBC_SHA
boolean—
DNSOverHTTPS

Configure DNS over HTTPS.

dictDNS over HTTPS
Enabledrequired

Enable DNS over HTTPS.

Default: false

boolean—
ProviderURL

URL to an alternative DNS over HTTPS provider.

stringProvider URL
Locked

If this is true, DNS over HTTPS preferences cannot be changed.

Default: false

boolean—
ExcludedDomains

List of excluded domains from DNS over HTTPS.

arrayExcluded Domains
stringExcluded Domains
Proxy

Configure proxy settings. These settings correspond to the connection settings in Firefox preferences. To specify ports, append them to the hostnames with a colon (:).

dict—
Moderequired

If this preference is enabled, you will be setting the proxy mode.

Range: No Proxy (none), Use system proxy settings (system), Manual proxy configuration (manual), Auto-detect proxy settings (autoDetect), Automatic proxy configuration (autoConfig)

string—
Locked

If this preference is enabled, Proxy preferences cannot be changed.

Default: false

boolean—
AutoLogin

If this preference is enabled, do not prompt for authentication if password is saved.

Default: false

boolean—
UseProxyForDNS

If this preference is enabled, you will use Proxy DNS when using SOCKS v5.

Default: false

boolean—
HTTPProxy

HTTP Proxy URL.

stringHTTP Proxy
UseHTTPProxyForAllProtocols

If this preference is enabled, use the HTTP proxy server for all protocols.

Default: false

boolean—
SSLProxy

SSL Proxy URL.

stringSSL Proxy
FTPProxy

FTP Proxy URL.

stringFTP Proxy
SOCKSProxy

SOCKS Proxy URL.

stringSOCKS Proxy
SOCKSVersion

Select SOCKS Version.

Range: 4 (4), 5 (5)

stringSOCKS Version
Passthrough

Proxy bypass URLs.

Default: "localhost, 127.0.0.1"

stringNo Proxy For
AutoConfigURL

Proxy bypass URLs.

stringAutomatic Proxy Configuration URL
SSLVersionMin

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

stringSSLVersionMin
SSLVersionMax

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

stringSSLVersionMax
NetworkPrediction

Enable or disable network prediction (DNS prefetching).

booleanNetwork Prediction
Cookies

Configure cookie preferences.

dict—
Allow

A list of origins (not domains) where cookies are always allowed.

arrayAllow
URL
stringURL
AllowSession

A list of origins (not domains) where cookies are only allowed for the current session.

arrayAllow Session
URL
stringURL
Block

A list of origins (not domains) where cookies are always blocked.

arrayBlock
URL
stringURL
Behavior

This has been added replacing the existing options Default, AcceptThirdParty, and RejectTracker.

Range: accept, reject-foreign, reject, limit-foreign, reject-tracker, reject-tracker-and-partition-foreign

string—
BehaviorPrivateBrowsing

Range: accept, reject-foreign, reject, limit-foreign, reject-tracker, reject-tracker-and-partition-foreign

stringBehavior: Private Browsing
Default

This sets the default value for "Accept cookies from websites".

Default: true

boolean—
AcceptThirdParty

This sets the default value for "Accept third-party cookies".

Range: always (always), never (never), from-visited (from-visited)

string—
ExpireAtSessionEnd

This determines when cookies expire.

Default: false

boolean—
RejectTracker

Only reject trackers.

Default: false

boolean—
Locked

If this is true, cookies preferences cannot be changed.

Default: false

boolean—
DisableFormHistory

Turn off saving information on web forms and the search bar.

Default: true

booleanDisable Form History
DisablePasswordReveal

Do not allow passwords to be shown in saved logins

Default: true

booleanDisable Password Reveal
DisableTelemetry

Prevent the upload of telemetry data.

Default: true

booleanDisable Telemetry
EnableTrackingProtection

Configure 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}

dictEnable Tracking Protection
Value

If 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: false

boolean—
Locked

If this is true, Tracking Protection preferences cannot be changed.

Default: false

boolean—
Cryptomining

If Cryptomining is set to true, cryptomining scripts on websites are blocked.

Default: false

boolean—
Fingerprinting

If Fingerprinting is set to true, fingerprinting scripts on websites are blocked.

Default: false

boolean—
FlashPlugin

Configure the default Flash plugin policy as well as origins for which Flash is allowed.

dictFlash Plugin Permissions
Allow

If 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.

arrayAllowed Domains
Allowed Domains
string—
Block

If 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.

arrayBlocked Domains
Blocked Domains
string—
Default

If 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: false

boolean—
Locked

If this is true, Flash preferences cannot be changed.

Default: false

boolean—
InstallAddonsPermission

Configure the default extension install policy as well as origins for extension installs are allowed.

dictInstall Add-ons Permissions
Allow

If 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.

arrayAllowed Domains
Allowed Domains
string—
Default

If this is set to false, add-ons cannot be installed by the user.

Default: false

boolean—
OfferToSaveLogins

Control whether or not Firefox offers to save passwords.

Default: false

booleanOffer To Save Logins
OfferToSaveLoginsDefault

Sets the default value of signon.rememberSignons without locking it.

Default: false

booleanOffer To Save Logins Default
PasswordManagerEnabled

Remove access to the password manager via preferences and blocks about:logins on Firefox 70.

Default: false

booleanEnable Password Manager
Permissions

Set permissions associated with camera, microphone, location, notifications, and autoplay.

dict—
Camera

This preference allows you to change the camera permissions.

dictCamera Permissions
Allow

If 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.

array—
Allowed Domains
string—
Block

If 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.

array—
Blocked Domains
string—
BlockNewRequests

If 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: true

booleanBlock New Requests
Locked

If 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: false

boolean—
Microphone

This preference allows you to change the microphone permissions.

dictMicrophone Permissions
Allow

If 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.

array—
Allowed Domains
string—
Block

If 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.

array—
Blocked Domains
string—
BlockNewRequests

If 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: true

booleanBlock New Requests
Locked

If 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: false

boolean—
Location

This preference allows you to change the location permissions.

dictLocation Permissions
Allow

If 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.

array—
Allowed Domains
string—
Block

If 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.

array—
Blocked Domains
string—
BlockNewRequests

If 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: true

booleanBlock New Requests
Locked

If 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: false

boolean—
Notifications

This preference allows you to change the notifications permissions.

dictNotifications Permissions
Allow

If 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.

array—
Allowed Domains
string—
Block

If 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.

array—
Blocked Domains
string—
BlockNewRequests

If 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: true

booleanBlock New Requests
Locked

If 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: false

boolean—
Autoplay

This preference allows you to change the autoplay permissions.

dictAutoplay Permissions
Allow

If 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.

array—
Allowed Domains
string—
Block

If 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.

array—
Blocked Domains
string—
Default

Configures the default Autoplay behavior.

Range: Allow Audio & Video (allow-audio-video), Block Audio (block-audio), Block Audio & Video (block-audio-video)

stringDefault Autoplay Behavior
Locked

If 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: false

booleanLocked
VirtualReality

This preference allows you to change the virtual reality permissions.

dictVirutal Reality Permissions
Allow

If 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.

array—
Allowed Domains
string—
Block

If 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.

array—
Blocked Domains
string—
BlockNewRequests

If 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: true

booleanBlock New Requests
Locked

If 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: false

boolean—
PopupBlocking

Configure the default pop-up window policy as well as origins for which pop-up windows are allowed.

dictPopup Blocking
Allow

Specify 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.

arrayAllowed Domains
Allowed Domains
string—
Default

If this is false, pop-up windows are allowed by default.

Default: true

boolean—
Locked

If this is true, pop-up blocking preferences cannot be changed.

Default: false

boolean—
Certificates

Trust certificates that have been added to the operating system certificate store by a user or administrator in the macOS Keychain.

dict—
ImportEnterpriseRoots

If 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: true

boolean—
Install

If 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.

arrayInstall
Certificate
string—
DisableSecurityBypass

Prevent the user from bypassing security in certain cases.

dictDisable Security Bypass
InvalidCertificate

Prevents 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: true

boolean—
SafeBrowsing

Prevents 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: true

boolean—
SecurityDevices

Install PKCS #11 modules.

Default: {"NAME_OF_DEVICE":"PATH_TO_LIBRARY_FOR_DEVICE"}

dict—
{{key}}
stringDevice Name
{{value}}
stringLibrary Path
UserMessaging

Prevent installing search engines from webpages.

dictSearch Engine Installs from Websites
WhatsNew

If enabled, remove the "What's New" icon and menuitem.

booleanWhat's New
ExtensionRecommendations

If enabled, don't recommend extensions.

booleanExtension Recomendations
FeatureRecommendations

If enabled, don't recommend browser features.

booleanFeature Recommendations
SkipOnboarding

If enabled, don't show onboarding messages on the new tab page.

booleanSkip Onboarding
UrlbarInterventions

If enabled, don't offer Firefox specific suggestions in the URL bar.

booleanURL Bar Interventions
LegacySameSiteCookieBehaviorEnabled

Enable default legacy SameSite cookie behavior setting.

booleanLegacy SameSite Cookie Behavior Enabled
LegacySameSiteCookieBehaviorEnabledForDomainList

Revert to legacy SameSite behavior for cookies on specified sites.

arrayLegacy SameSite Cookie Behavior Enabled for Domain List
stringDomain
WebsiteFilter

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

dict—
Blockrequired

If 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.

arrayBlock
Block
stringBlocked Sites
Exceptions

If 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.

arrayExceptions
Exceptions
stringExceptions To Website Filter
AllowedDomainsForApps

Comma-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.

stringAllowed Domains for Apps
AutoLaunchProtocolsFromOrigins

Comma-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.

arrayAuto Launch Protocols from Origins
dict—
protocol

The protocol to allow for specified URLs.

stringProtocol
allowed_origins

The protocol to allow for specified URLs.

arrayAllowed Origins
stringURL
CaptivePortal

Enable or disable the detection of captive portals.

booleanCaptive Portal
Preferences

Set and lock certain preferences.

dictPreferences
accessibility.force_disabled

If set to 1, platform accessibility is disabled.

Default: 0

Range: Not Disabled (0), Disabled (1)

integeraccessibility.force_disabled
app.update.auto

If false, Firefox doesn't automatically install update.

Default: true

booleanapp.update.auto
browser.bookmarks.autoExportHTML

If true, bookmarks are exported on shutdown.

Default: false

booleanbrowser.bookmarks.autoExportHTML
browser.bookmarks.file

If set, the name of the file where bookmarks are exported and imported.

stringbrowser.bookmarks.file
browser.bookmarks.restore_default_bookmarks

If true, bookmarks are restored to their defaults.

Default: false

booleanbrowser.bookmarks.restore_default_bookmarks
browser.cache.disk.enable

If false, don't store cache on the hard drive.

Default: true

booleanbrowser.cache.disk.enable
browser.cache.disk.parent_directory

If set, changes the location of the disk cache.

Default: "Profile temporary directory"

stringbrowser.cache.disk.parent_directory
browser.fixup.dns_first_for_single_words

If true, single words are sent to DNS, not directly to search.

Default: false

booleanbrowser.fixup.dns_first_for_single_words
browser.newtabpage.activity-stream.default.sites

If set, a list of URLs to use as the default top sites on the new tab page.

arraybrowser.newtabpage.activity-stream.default.sites
stringSites
browser.places.importBookmarksHTML

If true, bookmarks are always imported on startup.

booleanbrowser.places.importBookmarksHTML
browser.safebrowsing.malware.enabled

If false, malware protection is not enabled (Not recommended)

Default: true

booleanbrowser.safebrowsing.malware.enabled
browser.safebrowsing.phishing.enabled

If false, phishing protection is not enabled (Not recommended)

Default: true

booleanbrowser.safebrowsing.phishing.enabled
browser.search.update

If false, updates for search engines are not checked.

Default: true

booleanbrowser.search.update
browser.slowStartup.notificationDisabled

If true, a notification isn't shown if startup is slow.

Default: false

booleanbrowser.slowStartup.notificationDisabled
browser.tabs.warnOnClose

If false, there is no warning when the browser is closed.

Default: true

booleanbrowser.tabs.warnOnClose
browser.taskbar.previews.enable

If true, tab previews are shown in the Windows taskbar.

Default: false

booleanbrowser.taskbar.previews.enable
browser.urlbar.suggest.bookmark

If false, bookmarks aren't suggested when typing in the URL bar.

Default: true

booleanbrowser.urlbar.suggest.bookmark
browser.urlbar.suggest.history

If false, history isn't suggested when typing in the URL bar.

Default: true

booleanbrowser.urlbar.suggest.history
browser.urlbar.suggest.openpage

If false, open tabs aren't suggested when typing in the URL bar.

Default: true

booleanbrowser.urlbar.suggest.openpage
datareporting.policy.dataSubmissionPolicyBypassNotification

If true, don't show the privacy policy tab on first run.

Default: false

booleandatareporting.policy.dataSubmissionPolicyBypassNotification
dom.allow_scripts_to_close_windows

If false, web page can close windows.

Default: true

booleandom.allow_scripts_to_close_windows
dom.disable_window_flip

If false, web pages can focus and activate windows.

Default: true

booleandom.disable_window_flip
dom.disable_window_move_resize

If true, web pages can't move or resize windows.

Default: false

booleandom.disable_window_move_resize
dom.event.contextmenu.enabled

If false, web pages can't override context menus.

Default: true

booleandom.event.contextmenu.enabled
dom.keyboardevent.keypress.hack.dispatch_non_printable_keys.addl

See https://support.mozilla.org/en-US/kb/dom-events-changes-introduced-firefox-66

Default: ""

stringdom.keyboardevent.keypress.hack.dispatch_non_printable_keys.addl
dom.keyboardevent.keypress.hack.use_legacy_keycode_and_charcode.addl

See https://support.mozilla.org/en-US/kb/dom-events-changes-introduced-firefox-66

Default: ""

stringdom.keyboardevent.keypress.hack.use_legacy_keycode_and_charcode.addl
extensions.blocklist.enabled

If false, the extensions blocklist is not used (Not recommended)

Default: true

booleanextensions.blocklist.enabled
extensions.getAddons.showPane

If false, the Recommendations tab is not displayed in the Add-ons Manager.

Default: false

booleanextensions.getAddons.showPane
extensions.htmlaboutaddons.recommendations.enabled

If false, recommendations are not shown on the Extensions tab in the Add-ons Manager.

Default: true

booleanextensions.htmlaboutaddons.recommendations.enabled
geo.enabled

If false, the geolocation API is disabled.

Default: true

booleangeo.enabled
intl.accept_languages

If set, preferred language for web pages.

stringintl.accept_languages
media.eme.enabled

If false, Encrypted Media Extensions are not enabled.

Default: true

booleanmedia.eme.enabled
media.gmp-gmpopenh264.enabled

If false, the OpenH264 plugin is not downloaded.

Default: true

booleanmedia.gmp-gmpopenh264.enabled
media.gmp-widevinecdm.enabled

If false, the Widevine plugin is not downloaded.

Default: true

booleanmedia.gmp-widevinecdm.enabled
media.peerconnection.enabled

If false, WebRTC is disabled

Default: true

booleanmedia.peerconnection.enabled
media.peerconnection.ice.obfuscate_host_addresses.blocklist

If set, a list of domains for which mDNS hostname obfuscation is disabled.

arraymedia.peerconnection.ice.obfuscate_host_addresses.blocklist
stringDomains
network.dns.disableIPv6

If true, IPv6 DNS lokoups are disabled.

Default: false

booleannetwork.dns.disableIPv6
network.IDN_show_punycode

If true, display the punycode version of internationalized domain names.

Default: false

booleannetwork.IDN_show_punycode
places.history.enabled

If false, history is not enabled.

Default: true

booleanplaces.history.enabled
print.save_print_settings

If false, print settings are not saved between jobs.

Default: true

booleanprint.save_print_settings
security.default_personal_cert

If 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

stringsecurity.default_personal_cert
security.mixed_content.block_active_content

If false, mixed active content (HTTP and HTTPS) is not blocked.

Default: true

booleansecurity.mixed_content.block_active_content
security.osclientcerts.autoload

If true, client certificates are loaded from the operating system certificate store.

Default: false

booleansecurity.osclientcerts.autoload
security.ssl.errorReporting.enabled

If false, SSL errors cannot be sent to Mozilla.

Default: true

booleansecurity.ssl.errorReporting.enabled
security.tls.hello_downgrade_check

If false, the TLS 1.3 downgrade check is disabled.

Default: true

booleansecurity.tls.hello_downgrade_check
security.tls.enable_0rtt_data

If false, TLS early data is turned off.

Default: true

boolean—
security.tls.version.enable-deprecated

If true, browser will accept TLS 1.0. and TLS 1.1.

Default: false

boolean—
widget.content.gtk-theme-override

If set, overrides the GTK theme for widgets.

stringwidget.content.gtk-theme-override
SupportMenu

Adds a menuitem to the help menu for specifying support information.

dictSupport Menu
Title
stringTitle
URL
stringURL
AccessKey
stringAccessKey
MicrosoftEntraSSO

If 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: false

booleanAllow single sign-on for Microsoft Entra accounts on macOS