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
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
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
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
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
ExtensionUpdate
booleanExtension Update
3rdparty

Configure third party components.

dict3rd Party Configuration
EncryptedMediaExtensions

Enable or disable Encrypted Media Extensions and optionally lock it.

dictEncrypted Media Extensions
HardwareAcceleration

Control hardware acceleration.

booleanHardware Acceleration
FirefoxHome

Customize the Firefox Home page.

dictFirefoxHome
GenerativeAI

Configure generative AI features

dictGenerative AI
Homepage

Configure the default homepage and how Firefox starts.

dict
ShowHomeButton

Show the home button on the toolbar.

Default: false

booleanShow Home Button
LocalFileLinks

Enable linking to local files by origin

arrayLocal File Links
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
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
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)
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
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
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
DNSOverHTTPS

Configure DNS over HTTPS.

dictDNS over HTTPS
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
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
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
FlashPlugin

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

dictFlash Plugin Permissions
InstallAddonsPermission

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

dictInstall Add-ons Permissions
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
PopupBlocking

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

dictPopup Blocking
Certificates

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

dict
DisableSecurityBypass

Prevent the user from bypassing security in certain cases.

dictDisable Security Bypass
SecurityDevices

Install PKCS #11 modules.

Default: {"NAME_OF_DEVICE":"PATH_TO_LIBRARY_FOR_DEVICE"}

dict
UserMessaging

Prevent installing search engines from webpages.

dictSearch Engine Installs from Websites
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
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
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
CaptivePortal

Enable or disable the detection of captive portals.

booleanCaptive Portal
Preferences

Set and lock certain preferences.

dictPreferences
SupportMenu

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

dictSupport Menu
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
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
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
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)
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
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
Locked
booleanLocked (Authentication)
PrivateBrowsing

Enables integrated authentication in prviate browsing

booleanPrivate Browsing
Domain
string
Domain
string
Domain
string
NTLMrequired

Default: true

boolean
SPNEGOrequired

Default: true

boolean
NTLMrequired

Default: true

boolean
SPNEGOrequired

Default: true

boolean
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
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
Install

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

arrayInstall
Uninstall

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

arrayUninstall
Locked

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

arrayLocked
Install
stringInstall
Uninstall
stringExtension ID To Uninstall
Locked
stringExtension ID To Lock
{{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
allowed_types

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

arrayAllowed Types
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
updates_disabled

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

booleanDisable Updates
string

Range: extension, theme, dictionary, langpack

string
stringRestricted Domain
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
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
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
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
URL

Optional. Set the default home page.

string
Additional

Optional. Set additional homepages.

arrayAdditional Homepages
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
Additional
string
string
Enabled
boolean
Locked
boolean
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
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
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
Add

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

arrayAdd Search Engines
stringHidden 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
mimeTypes

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

dictMIME Types
schemes
dictSchemes
extensions
dictExtensions
{{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
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
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
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
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
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
Allow

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

arrayAllow
AllowSession

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

arrayAllow Session
Block

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

arrayBlock
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
URL
stringURL
URL
stringURL
URL
stringURL
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
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
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
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
Allowed Domains
string
Blocked Domains
string
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
Default

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

Default: false

boolean
Allowed Domains
string
Camera

This preference allows you to change the camera permissions.

dictCamera Permissions
Microphone

This preference allows you to change the microphone permissions.

dictMicrophone Permissions
Location

This preference allows you to change the location permissions.

dictLocation Permissions
Notifications

This preference allows you to change the notifications permissions.

dictNotifications Permissions
Autoplay

This preference allows you to change the autoplay permissions.

dictAutoplay Permissions
VirtualReality

This preference allows you to change the virtual reality permissions.

dictVirutal Reality 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
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
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
Allowed Domains
string
Blocked Domains
string
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
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
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
Allowed Domains
string
Blocked Domains
string
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
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
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
Allowed Domains
string
Blocked Domains
string
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
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
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
Allowed Domains
string
Blocked Domains
string
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
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
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
Allowed Domains
string
Blocked Domains
string
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
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
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
Allowed Domains
string
Blocked Domains
string
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
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
Allowed Domains
string
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
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
{{key}}
stringDevice Name
{{value}}
stringLibrary Path
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
stringDomain
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
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
Block
stringBlocked Sites
Exceptions
stringExceptions To Website Filter
dict
protocol

The protocol to allow for specified URLs.

stringProtocol
allowed_origins

The protocol to allow for specified URLs.

arrayAllowed Origins
stringURL
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
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
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
stringSites
stringDomains
Title
stringTitle
URL
stringURL
AccessKey
stringAccessKey