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.
Configuration Keys (91)
| Key | Type | Title |
|---|---|---|
EnterprisePoliciesEnabledrequiredEnable policy support on macOS. Default: true | boolean | Enable Enterprise Policies |
PFC_SegmentedControl_0required | string | — |
General_SegmentedControlrequired | string | — |
Privacy_SegmentedControlrequired | string | — |
Security_SegmentedControlrequired | string | — |
BackgroundAppUpdateEnable 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. | boolean | Background App Update |
AppAutoUpdateEnable or disable automatic application update. | boolean | Firefox Auto Update |
AppUpdateURLChange the URL for application update. | string | Application Update URL |
AuthenticationConfigure sites that support integrated authentication. | dict | — |
BlockAboutAddonsBlock access to the Add-ons Manager (about:addons). | boolean | Block about:addons page |
BlockAboutConfigBlock access to about:config. | boolean | Block about:config page |
BlockAboutProfilesBlock access to About Profiles (about:profiles). | boolean | Block about:profiles page |
BlockAboutSupportBlock access to Troubleshooting Information (about:support). | boolean | Block about:support page |
BookmarksAdd bookmarks in either the bookmarks toolbar or menu. | array | — |
DefaultDownloadDirectorySet the default download directory. | string | Default Download Directory |
DisableAppUpdateTurn off application updates. | boolean | Disable Application Update |
DisableBuiltinPDFViewerDisable the built in PDF viewer. PDF files are downloaded and sent externally. | boolean | Disable Built-in PDF Viewer |
PDFjsDisable or configure PDF.js, the built-in PDF viewer. | dict | PDF.js |
DisableDeveloperToolsRemove access to all developer tools. | boolean | Disable Developer Tools |
DisableFeedbackCommandsDisable the menus for reporting sites (Submit Feedback, Report Deceptive Site). | boolean | Disable Feedback Commands |
DisableFirefoxAccountsDisable Firefox Accounts integration (Sync). | boolean | Disable Firefox Accounts / Sync |
DisableFirefoxScreenshotsRemove access to Firefox Screenshots. | boolean | Disable Firefox Screenshots |
DisableFirefoxStudiesDisable Firefox studies (Shield). | boolean | Disable Firefox Studies (Shield) |
DisableForgetButtonDisable the "Forget" button. | boolean | Disable Forget Button |
DisableMasterPasswordCreationRemove the master password functionality. If this preference is set to true, the master password functionality is removed. | boolean | Disable Master Password Creation |
PrimaryPasswordRequire or prevent using a primary (formerly master) password. If this value is true, a primary password is required. | boolean | Enable Primary Password |
DisablePocketRemove Pocket in the Firefox UI. | boolean | Disable Pocket |
DisablePrivateBrowsingRemove access to private browsing. | boolean | Disable Private Browsing |
DisableProfileImportDisables the "Import data from another browser" option in the bookmarks window. | boolean | Disable Profile Import |
DisableProfileRefreshDisable 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. | boolean | Disable Profile Refresh |
DisableSafeModeDisable safe mode within the browser. | boolean | Disable Safe Mode |
DisableSetDesktopBackgroundThis preference removes the "Set As Desktop Background..." menu item when right clicking on an image. | boolean | Disable Set Desktop Background |
DisplayMenuBarSet the initial state of the menubar. A user can still hide it and it will stay hidden. | boolean | Display Menu Bar |
DisableSystemAddonUpdatePrevent system add-ons from being installed or update. | boolean | Disable System Add-on Update |
DisplayBookmarksToolbarSet the initial state of the bookmarks toolbar. A user can still hide it and it will stay hidden. | boolean | Display Bookmarks Toolbar |
DontCheckDefaultBrowserDon't check if Firefox is the default browser at startup. | boolean | Do Not Check Default Browser |
DownloadDirectorySet and lock the download directory. | string | Download Directory |
ExtensionsControl 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 | — |
ExtensionSettingsManage 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 | boolean | Extension Update |
3rdpartyConfigure third party components. | dict | 3rd Party Configuration |
EncryptedMediaExtensionsEnable or disable Encrypted Media Extensions and optionally lock it. | dict | Encrypted Media Extensions |
HardwareAccelerationControl hardware acceleration. | boolean | Hardware Acceleration |
FirefoxHomeCustomize the Firefox Home page. | dict | FirefoxHome |
GenerativeAIConfigure generative AI features | dict | Generative AI |
HomepageConfigure the default homepage and how Firefox starts. | dict | — |
ShowHomeButtonShow the home button on the toolbar. Default: false | boolean | Show Home Button |
LocalFileLinksEnable linking to local files by origin | array | Local File Links |
NewTabPageEnable or disable the New Tab page. | boolean | New Tab Page |
NoDefaultBookmarksDisable the creation of default bookmarks. | boolean | No Default Bookmarks |
OverrideFirstRunPageOverride 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 (|). | string | Override First Run Page |
OverridePostUpdatePageOverride the upgrade page. If the value is blank, no upgrade page is displayed. | string | Override Post Update Page |
PictureInPictureEnable or disable Picture-in-Picture. | dict | Picture-in-Picture |
PromptForDownloadLocationAsk where to save each file before downloading. | boolean | Prompt for Download Location |
RequestedLocalesSet the the list of requested locales for the application in order of preference. It will cause the corresponding language pack to become active. | array | Requested Locales |
SanitizeOnShutdownClear data on shutdown. Choose from Cache, Cookies, Download History, Form & Search History, Browsing History, Active Logins, Site Preferences and Offline Website Data. | dict | Sanitize On Shutdown (Selective) |
SearchBarSet whether or not search bar is displayed. Default: "separate" Range: Separate (separate), Unified (unified) | string | Search Bar |
SearchEnginesSet whether or not search bar is displayed. | dict | Search Engines |
SearchSuggestEnabledEnable search suggestions. | boolean | Enable Search Suggest |
HandlersConfigure 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 | — |
DisabledCiphersDisable 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. | dict | Disabled Ciphers |
DNSOverHTTPSConfigure DNS over HTTPS. | dict | DNS over HTTPS |
ProxyConfigure proxy settings. These settings correspond to the connection settings in Firefox preferences. To specify ports, append them to the hostnames with a colon (:). | dict | — |
SSLVersionMinRange: TLS 1.0 (tls1), TLS 1.1 (tls1.1), TLS 1.2 (tls1.2), TLS 1.3 (tls1.3) | string | SSLVersionMin |
SSLVersionMaxRange: TLS 1.0 (tls1), TLS 1.1 (tls1.1), TLS 1.2 (tls1.2), TLS 1.3 (tls1.3) | string | SSLVersionMax |
NetworkPredictionEnable or disable network prediction (DNS prefetching). | boolean | Network Prediction |
CookiesConfigure cookie preferences. | dict | — |
DisableFormHistoryTurn off saving information on web forms and the search bar. Default: true | boolean | Disable Form History |
DisablePasswordRevealDo not allow passwords to be shown in saved logins Default: true | boolean | Disable Password Reveal |
DisableTelemetryPrevent the upload of telemetry data. Default: true | boolean | Disable Telemetry |
EnableTrackingProtectionConfigure 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} | dict | Enable Tracking Protection |
FlashPluginConfigure the default Flash plugin policy as well as origins for which Flash is allowed. | dict | Flash Plugin Permissions |
InstallAddonsPermissionConfigure the default extension install policy as well as origins for extension installs are allowed. | dict | Install Add-ons Permissions |
OfferToSaveLoginsControl whether or not Firefox offers to save passwords. Default: false | boolean | Offer To Save Logins |
OfferToSaveLoginsDefaultSets the default value of signon.rememberSignons without locking it. Default: false | boolean | Offer To Save Logins Default |
PasswordManagerEnabledRemove access to the password manager via preferences and blocks about:logins on Firefox 70. Default: false | boolean | Enable Password Manager |
PermissionsSet permissions associated with camera, microphone, location, notifications, and autoplay. | dict | — |
PopupBlockingConfigure the default pop-up window policy as well as origins for which pop-up windows are allowed. | dict | Popup Blocking |
CertificatesTrust certificates that have been added to the operating system certificate store by a user or administrator in the macOS Keychain. | dict | — |
DisableSecurityBypassPrevent the user from bypassing security in certain cases. | dict | Disable Security Bypass |
SecurityDevicesInstall PKCS #11 modules. Default: {"NAME_OF_DEVICE":"PATH_TO_LIBRARY_FOR_DEVICE"} | dict | — |
UserMessagingPrevent installing search engines from webpages. | dict | Search Engine Installs from Websites |
LegacySameSiteCookieBehaviorEnabledEnable default legacy SameSite cookie behavior setting. | boolean | Legacy SameSite Cookie Behavior Enabled |
LegacySameSiteCookieBehaviorEnabledForDomainListRevert to legacy SameSite behavior for cookies on specified sites. | array | Legacy SameSite Cookie Behavior Enabled for Domain List |
WebsiteFilterBlock 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 | — |
AllowedDomainsForAppsComma-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. | string | Allowed Domains for Apps |
AutoLaunchProtocolsFromOriginsComma-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. | array | Auto Launch Protocols from Origins |
CaptivePortalEnable or disable the detection of captive portals. | boolean | Captive Portal |
PreferencesSet and lock certain preferences. | dict | Preferences |
SupportMenuAdds a menuitem to the help menu for specifying support information. | dict | Support Menu |
MicrosoftEntraSSOIf 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 | boolean | Allow single sign-on for Microsoft Entra accounts on macOS |
SPNEGOIf 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. | array | SPNEGO |
DelegatedIf 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 | array | Delegated |
NTLMIf 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. | array | Microsoft Challenge/Response (NTLM) |
AllowNonFQDNIf 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. | dict | Allow Non-FQDN |
AllowProxiesIf 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. | dict | Allow Proxies |
Locked | boolean | Locked (Authentication) |
PrivateBrowsingEnables integrated authentication in prviate browsing | boolean | Private Browsing |
Domain | string | — |
Domain | string | — |
Domain | string | — |
NTLMrequiredDefault: true | boolean | — |
SPNEGOrequiredDefault: true | boolean | — |
NTLMrequiredDefault: true | boolean | — |
SPNEGOrequiredDefault: true | boolean | — |
Bookmarks | dict | — |
TitlerequiredBookmark Title | string | — |
URLrequiredFull URL to be bookmarked (e.g. https://www.example.org/) | string | — |
PlacementPlace bookmark in either the Bookmark menu or Bookmark Toolbar. Range: toolbar (toolbar), menu (menu) | string | — |
FaviconURL to icon file to display on bookmark (e.g. https://www.example.org/favicon.ico) | string | — |
FolderFolder 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 | — |
EnabledIf Enabled is set to false, the built-in PDF viewer is disabled. | boolean | — |
EnablePermissionsIf EnablePermissions is set to true, the built-in PDF viewer will honor document permissions like preventing the copying of text. | boolean | — |
InstallA list of URLs or native paths for extensions to be installed. | array | Install |
UninstallA list of extension IDs that should be uninstalled if found. | array | Uninstall |
LockedA list of extension IDs that the user cannot disable or uninstall. | array | Locked |
Install | string | Install |
Uninstall | string | Extension ID To Uninstall |
Locked | string | Extension ID To Lock |
{{key}} | string | Extension ID |
{{value}} | dict | — |
installation_modeMaps 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) | string | Installation Mode |
install_urlMaps 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. | string | Install URL |
install_sourcesEach item in this list is an extension-style match pattern. | array | Install Sources |
allowed_typesThis setting allowlists the allowed types of extension/apps that can be installed in Firefox. | array | Allowed Types |
blocked_install_messageThis maps to a string specifying the error message to display to users if they're blocked from installing an extension. | string | — |
restricted_domainsAn array of domains on which content scripts can't be run. | array | Restricted Domains |
updates_disabledIndicates whether or not to disable automatic updates for an individual extension. | boolean | Disable Updates |
| string | — |
Range: extension, theme, dictionary, langpack | string | — |
| string | Restricted Domain |
ExtensionsConfigure third party extensions. Keys in this dictionary specify IDs of extensions to configure, and values are dictionaries containing each third party extension configuration. | dict | 3rd Party Extension Configuration |
{{key}} | string | Extension ID |
{{value}} | dict | Extension Configuration |
EnabledIf Enabled is set to false, encrypted media extensions (like Widevine) are not downloaded by Firefox unless the user consents to installing them. | boolean | — |
LockedIf 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 | — |
SearchDefault: false | boolean | Search |
TopSitesDefault: false | boolean | TopSites |
SponsoredTopSitesDefault: false | boolean | Sponsored Top Sites |
HighlightsDefault: false | boolean | Highlights |
PocketDefault: false | boolean | |
SponsoredPocketDefault: false | boolean | Sponsored Pocket |
SnippetsDefault: false | boolean | Snippets |
LockedDefault: false | boolean | Locked |
EnabledControls whether generative AI features are enabled by default Default: false | boolean | Enabled |
ChatbotControls access to AI chatbots in the sidebar Default: false | boolean | ChatBot |
LinkPreviewsControls whether AI is used to generate link previews Default: false | boolean | Link Previews |
TabGroupsControls whether AI is used to suggest names and tabs for tab groups Default: false | boolean | Tab Groups |
LockedPrevents the user from changing generative AI preferences Default: false | boolean | Locked |
URLOptional. Set the default home page. | string | — |
AdditionalOptional. Set additional homepages. | array | Additional Homepages |
StartPageOptional. 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) | string | Start Page |
LockedIf true, prevents the user from changing homepage preferences. Default: false | boolean | — |
Additional | string | — |
| string | — |
Enabled | boolean | — |
Locked | boolean | — |
actionAction 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) | string | Action |
CacheDefault: false | boolean | — |
CookiesDefault: false | boolean | — |
DownloadsDefault: false | boolean | — |
FormDataDefault: false | boolean | Form Data |
HistoryDefault: false | boolean | — |
SessionsDefault: false | boolean | — |
SiteSettingsDefault: false | boolean | Site Settings |
OfflineAppsDefault: false | boolean | Offline Apps |
LockedDefault: false | boolean | — |
DefaultSet the default search engine. This policy is only available on the ESR. | string | — |
PreventInstallsPrevent installing search engines from webpages. This policy is only available on the ESR. | boolean | — |
RemoveHide built-in search engines. This policy is only available on the ESR. | array | — |
AddAdd new search engines. This policy is only available on the ESR. | array | Add Search Engines |
| string | Hidden Search Engines |
| dict | Search Engines |
NameName of the search engine | string | — |
URLTemplate | string | — |
MethodRange: GET, POST | string | — |
IconURLURL for the icon to use | string | — |
Aliaskeyword to use for the engine | string | — |
DescriptionDescription of the search engine. | string | — |
PostDataPOST data as name value pairs separated by '&' | string | — |
SuggestURLTemplateSearch suggestions URL with {searchTerms} to substitute for the search term. | string | — |
EncodingThe query charset for the engine. Default: "UTF-8" | string | — |
mimeTypesSpecify MIME types. More info here: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types | dict | MIME Types |
schemes | dict | Schemes |
extensions | dict | Extensions |
{{key}}https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types | string | MIME Type |
{{value}} | dict | — |
actionCan be either saveToDisk, useHelperApp, useSystemDefault. Range: Save to Disk (saveToDisk), Use Helper App (useHelperApp), Use System Default (useSystemDefault) | string | Action |
askIf true, the user is asked if what they want to do with the file. If false, the action is taken without user intervention. | boolean | Ask |
actionCan be either saveToDisk, useHelperApp, useSystemDefault. Range: Save to Disk (saveToDisk), Use Helper App (useHelperApp), Use System Default (useSystemDefault) | string | Action |
askIf true, the user is asked if what they want to do with the file. If false, the action is taken without user intervention. | boolean | Ask |
handlersAn 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. | array | Handlers |
| dict | MIME Type |
nameThe display name of the handler (might not be used). | string | Name |
pathThe native path to the executable to be used. | string | Path |
uriTemplateA url to a web based application handler. The URL must be https and contain a %s to be used for substitution. | string | URI Template |
actionCan be either saveToDisk, useHelperApp, useSystemDefault. Range: Save to Disk (saveToDisk), Use Helper App (useHelperApp), Use System Default (useSystemDefault) | string | Action |
askIf true, the user is asked if what they want to do with the file. If false, the action is taken without user intervention. | boolean | Ask |
handlersAn 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. | array | Handlers |
| dict | — |
nameThe display name of the handler (might not be used). | string | Name |
pathThe native path to the executable to be used. | string | Path |
uriTemplateA url to a web based application handler. The URL must be https and contain a %s to be used for substitution. | string | URI 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 | — |
EnabledrequiredEnable DNS over HTTPS. Default: false | boolean | — |
ProviderURLURL to an alternative DNS over HTTPS provider. | string | Provider URL |
LockedIf this is true, DNS over HTTPS preferences cannot be changed. Default: false | boolean | — |
ExcludedDomainsList of excluded domains from DNS over HTTPS. | array | Excluded Domains |
| string | Excluded Domains |
ModerequiredIf 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 | — |
LockedIf this preference is enabled, Proxy preferences cannot be changed. Default: false | boolean | — |
AutoLoginIf this preference is enabled, do not prompt for authentication if password is saved. Default: false | boolean | — |
UseProxyForDNSIf this preference is enabled, you will use Proxy DNS when using SOCKS v5. Default: false | boolean | — |
HTTPProxyHTTP Proxy URL. | string | HTTP Proxy |
UseHTTPProxyForAllProtocolsIf this preference is enabled, use the HTTP proxy server for all protocols. Default: false | boolean | — |
SSLProxySSL Proxy URL. | string | SSL Proxy |
FTPProxyFTP Proxy URL. | string | FTP Proxy |
SOCKSProxySOCKS Proxy URL. | string | SOCKS Proxy |
SOCKSVersionSelect SOCKS Version. Range: 4 (4), 5 (5) | string | SOCKS Version |
PassthroughProxy bypass URLs. Default: "localhost, 127.0.0.1" | string | No Proxy For |
AutoConfigURLProxy bypass URLs. | string | Automatic Proxy Configuration URL |
AllowA list of origins (not domains) where cookies are always allowed. | array | Allow |
AllowSessionA list of origins (not domains) where cookies are only allowed for the current session. | array | Allow Session |
BlockA list of origins (not domains) where cookies are always blocked. | array | Block |
BehaviorThis 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 | — |
BehaviorPrivateBrowsingRange: accept, reject-foreign, reject, limit-foreign, reject-tracker, reject-tracker-and-partition-foreign | string | Behavior: Private Browsing |
DefaultThis sets the default value for "Accept cookies from websites". Default: true | boolean | — |
AcceptThirdPartyThis sets the default value for "Accept third-party cookies". Range: always (always), never (never), from-visited (from-visited) | string | — |
ExpireAtSessionEndThis determines when cookies expire. Default: false | boolean | — |
RejectTrackerOnly reject trackers. Default: false | boolean | — |
LockedIf this is true, cookies preferences cannot be changed. Default: false | boolean | — |
URL | string | URL |
URL | string | URL |
URL | string | URL |
ValueIf 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 | — |
LockedIf this is true, Tracking Protection preferences cannot be changed. Default: false | boolean | — |
CryptominingIf Cryptomining is set to true, cryptomining scripts on websites are blocked. Default: false | boolean | — |
FingerprintingIf Fingerprinting is set to true, fingerprinting scripts on websites are blocked. Default: false | boolean | — |
AllowIf 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. | array | Allowed Domains |
BlockIf 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. | array | Blocked Domains |
DefaultIf 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 | — |
LockedIf this is true, Flash preferences cannot be changed. Default: false | boolean | — |
Allowed Domains | string | — |
Blocked Domains | string | — |
AllowIf 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. | array | Allowed Domains |
DefaultIf this is set to false, add-ons cannot be installed by the user. Default: false | boolean | — |
Allowed Domains | string | — |
CameraThis preference allows you to change the camera permissions. | dict | Camera Permissions |
MicrophoneThis preference allows you to change the microphone permissions. | dict | Microphone Permissions |
LocationThis preference allows you to change the location permissions. | dict | Location Permissions |
NotificationsThis preference allows you to change the notifications permissions. | dict | Notifications Permissions |
AutoplayThis preference allows you to change the autoplay permissions. | dict | Autoplay Permissions |
VirtualRealityThis preference allows you to change the virtual reality permissions. | dict | Virutal Reality Permissions |
AllowIf 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 | — |
BlockIf 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 | — |
BlockNewRequestsIf 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 | boolean | Block New Requests |
LockedIf 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 | — |
AllowIf 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 | — |
BlockIf 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 | — |
BlockNewRequestsIf 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 | boolean | Block New Requests |
LockedIf 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 | — |
AllowIf 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 | — |
BlockIf 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 | — |
BlockNewRequestsIf 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 | boolean | Block New Requests |
LockedIf 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 | — |
AllowIf 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 | — |
BlockIf 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 | — |
BlockNewRequestsIf 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 | boolean | Block New Requests |
LockedIf 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 | — |
AllowIf 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 | — |
BlockIf 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 | — |
DefaultConfigures the default Autoplay behavior. Range: Allow Audio & Video (allow-audio-video), Block Audio (block-audio), Block Audio & Video (block-audio-video) | string | Default Autoplay Behavior |
LockedIf 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 | boolean | Locked |
Allowed Domains | string | — |
Blocked Domains | string | — |
AllowIf 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 | — |
BlockIf 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 | — |
BlockNewRequestsIf 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 | boolean | Block New Requests |
LockedIf 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 | — |
AllowSpecify 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. | array | Allowed Domains |
DefaultIf this is false, pop-up windows are allowed by default. Default: true | boolean | — |
LockedIf this is true, pop-up blocking preferences cannot be changed. Default: false | boolean | — |
Allowed Domains | string | — |
ImportEnterpriseRootsIf 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 | — |
InstallIf 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. | array | Install |
Certificate | string | — |
InvalidCertificatePrevents 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 | — |
SafeBrowsingPrevents 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}} | string | Device Name |
{{value}} | string | Library Path |
WhatsNewIf enabled, remove the "What's New" icon and menuitem. | boolean | What's New |
ExtensionRecommendationsIf enabled, don't recommend extensions. | boolean | Extension Recomendations |
FeatureRecommendationsIf enabled, don't recommend browser features. | boolean | Feature Recommendations |
SkipOnboardingIf enabled, don't show onboarding messages on the new tab page. | boolean | Skip Onboarding |
UrlbarInterventionsIf enabled, don't offer Firefox specific suggestions in the URL bar. | boolean | URL Bar Interventions |
| string | Domain |
BlockrequiredIf 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. | array | Block |
ExceptionsIf 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. | array | Exceptions |
Block | string | Blocked Sites |
Exceptions | string | Exceptions To Website Filter |
| dict | — |
protocolThe protocol to allow for specified URLs. | string | Protocol |
allowed_originsThe protocol to allow for specified URLs. | array | Allowed Origins |
| string | URL |
accessibility.force_disabledIf set to 1, platform accessibility is disabled. Default: 0 Range: Not Disabled (0), Disabled (1) | integer | accessibility.force_disabled |
app.update.autoIf false, Firefox doesn't automatically install update. Default: true | boolean | app.update.auto |
browser.bookmarks.autoExportHTMLIf true, bookmarks are exported on shutdown. Default: false | boolean | browser.bookmarks.autoExportHTML |
browser.bookmarks.fileIf set, the name of the file where bookmarks are exported and imported. | string | browser.bookmarks.file |
browser.bookmarks.restore_default_bookmarksIf true, bookmarks are restored to their defaults. Default: false | boolean | browser.bookmarks.restore_default_bookmarks |
browser.cache.disk.enableIf false, don't store cache on the hard drive. Default: true | boolean | browser.cache.disk.enable |
browser.cache.disk.parent_directoryIf set, changes the location of the disk cache. Default: "Profile temporary directory" | string | browser.cache.disk.parent_directory |
browser.fixup.dns_first_for_single_wordsIf true, single words are sent to DNS, not directly to search. Default: false | boolean | browser.fixup.dns_first_for_single_words |
browser.newtabpage.activity-stream.default.sitesIf set, a list of URLs to use as the default top sites on the new tab page. | array | browser.newtabpage.activity-stream.default.sites |
browser.places.importBookmarksHTMLIf true, bookmarks are always imported on startup. | boolean | browser.places.importBookmarksHTML |
browser.safebrowsing.malware.enabledIf false, malware protection is not enabled (Not recommended) Default: true | boolean | browser.safebrowsing.malware.enabled |
browser.safebrowsing.phishing.enabledIf false, phishing protection is not enabled (Not recommended) Default: true | boolean | browser.safebrowsing.phishing.enabled |
browser.search.updateIf false, updates for search engines are not checked. Default: true | boolean | browser.search.update |
browser.slowStartup.notificationDisabledIf true, a notification isn't shown if startup is slow. Default: false | boolean | browser.slowStartup.notificationDisabled |
browser.tabs.warnOnCloseIf false, there is no warning when the browser is closed. Default: true | boolean | browser.tabs.warnOnClose |
browser.taskbar.previews.enableIf true, tab previews are shown in the Windows taskbar. Default: false | boolean | browser.taskbar.previews.enable |
browser.urlbar.suggest.bookmarkIf false, bookmarks aren't suggested when typing in the URL bar. Default: true | boolean | browser.urlbar.suggest.bookmark |
browser.urlbar.suggest.historyIf false, history isn't suggested when typing in the URL bar. Default: true | boolean | browser.urlbar.suggest.history |
browser.urlbar.suggest.openpageIf false, open tabs aren't suggested when typing in the URL bar. Default: true | boolean | browser.urlbar.suggest.openpage |
datareporting.policy.dataSubmissionPolicyBypassNotificationIf true, don't show the privacy policy tab on first run. Default: false | boolean | datareporting.policy.dataSubmissionPolicyBypassNotification |
dom.allow_scripts_to_close_windowsIf false, web page can close windows. Default: true | boolean | dom.allow_scripts_to_close_windows |
dom.disable_window_flipIf false, web pages can focus and activate windows. Default: true | boolean | dom.disable_window_flip |
dom.disable_window_move_resizeIf true, web pages can't move or resize windows. Default: false | boolean | dom.disable_window_move_resize |
dom.event.contextmenu.enabledIf false, web pages can't override context menus. Default: true | boolean | dom.event.contextmenu.enabled |
dom.keyboardevent.keypress.hack.dispatch_non_printable_keys.addlSee https://support.mozilla.org/en-US/kb/dom-events-changes-introduced-firefox-66 Default: "" | string | dom.keyboardevent.keypress.hack.dispatch_non_printable_keys.addl |
dom.keyboardevent.keypress.hack.use_legacy_keycode_and_charcode.addlSee https://support.mozilla.org/en-US/kb/dom-events-changes-introduced-firefox-66 Default: "" | string | dom.keyboardevent.keypress.hack.use_legacy_keycode_and_charcode.addl |
extensions.blocklist.enabledIf false, the extensions blocklist is not used (Not recommended) Default: true | boolean | extensions.blocklist.enabled |
extensions.getAddons.showPaneIf false, the Recommendations tab is not displayed in the Add-ons Manager. Default: false | boolean | extensions.getAddons.showPane |
extensions.htmlaboutaddons.recommendations.enabledIf false, recommendations are not shown on the Extensions tab in the Add-ons Manager. Default: true | boolean | extensions.htmlaboutaddons.recommendations.enabled |
geo.enabledIf false, the geolocation API is disabled. Default: true | boolean | geo.enabled |
intl.accept_languagesIf set, preferred language for web pages. | string | intl.accept_languages |
media.eme.enabledIf false, Encrypted Media Extensions are not enabled. Default: true | boolean | media.eme.enabled |
media.gmp-gmpopenh264.enabledIf false, the OpenH264 plugin is not downloaded. Default: true | boolean | media.gmp-gmpopenh264.enabled |
media.gmp-widevinecdm.enabledIf false, the Widevine plugin is not downloaded. Default: true | boolean | media.gmp-widevinecdm.enabled |
media.peerconnection.enabledIf false, WebRTC is disabled Default: true | boolean | media.peerconnection.enabled |
media.peerconnection.ice.obfuscate_host_addresses.blocklistIf set, a list of domains for which mDNS hostname obfuscation is disabled. | array | media.peerconnection.ice.obfuscate_host_addresses.blocklist |
network.dns.disableIPv6If true, IPv6 DNS lokoups are disabled. Default: false | boolean | network.dns.disableIPv6 |
network.IDN_show_punycodeIf true, display the punycode version of internationalized domain names. Default: false | boolean | network.IDN_show_punycode |
places.history.enabledIf false, history is not enabled. Default: true | boolean | places.history.enabled |
print.save_print_settingsIf false, print settings are not saved between jobs. Default: true | boolean | print.save_print_settings |
security.default_personal_certIf 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 | string | security.default_personal_cert |
security.mixed_content.block_active_contentIf false, mixed active content (HTTP and HTTPS) is not blocked. Default: true | boolean | security.mixed_content.block_active_content |
security.osclientcerts.autoloadIf true, client certificates are loaded from the operating system certificate store. Default: false | boolean | security.osclientcerts.autoload |
security.ssl.errorReporting.enabledIf false, SSL errors cannot be sent to Mozilla. Default: true | boolean | security.ssl.errorReporting.enabled |
security.tls.hello_downgrade_checkIf false, the TLS 1.3 downgrade check is disabled. Default: true | boolean | security.tls.hello_downgrade_check |
security.tls.enable_0rtt_dataIf false, TLS early data is turned off. Default: true | boolean | — |
security.tls.version.enable-deprecatedIf true, browser will accept TLS 1.0. and TLS 1.1. Default: false | boolean | — |
widget.content.gtk-theme-overrideIf set, overrides the GTK theme for widgets. | string | widget.content.gtk-theme-override |
| string | Sites |
| string | Domains |
Title | string | Title |
URL | string | URL |
AccessKey | string | AccessKey |