diff --git a/src/content/docs/reference/policies/3rdparty.mdx b/src/content/docs/reference/policies/3rdparty.mdx index 6e21272..8f2be5d 100644 --- a/src/content/docs/reference/policies/3rdparty.mdx +++ b/src/content/docs/reference/policies/3rdparty.mdx @@ -19,6 +19,12 @@ For GPO and Intune, the extension developer should provide an ADMX file. +## Values + +- `Extensions`: An object keyed by extension ID. + The value for each ID is the configuration passed to that extension. + Firefox does not define those keys and values, the extension does, so check the extension's documentation for what it accepts. + ## macOS ```xml diff --git a/src/content/docs/reference/policies/EnterprisePoliciesEnabled.mdx b/src/content/docs/reference/policies/EnterprisePoliciesEnabled.mdx index 9dae036..fabaa22 100644 --- a/src/content/docs/reference/policies/EnterprisePoliciesEnabled.mdx +++ b/src/content/docs/reference/policies/EnterprisePoliciesEnabled.mdx @@ -20,6 +20,11 @@ See [Configuring policies](/guides/policies-configuration/) for where each polic > - Setting `EnterprisePoliciesEnabled` in `policies.json` has no effect and is reported as an error in `about:policies`. > For this reason, all non-macOS sections are omitted deliberately from this page. +## Values + +- Set to `true` to enable policy support on macOS, so Firefox reads the policies in the plist. +- Set to `false`, or leave the key out, and Firefox ignores every policy in the plist. + ## macOS ```xml diff --git a/src/content/docs/reference/policies/ExemptDomainFileTypePairsFromFileTypeDownloadWarnings.mdx b/src/content/docs/reference/policies/ExemptDomainFileTypePairsFromFileTypeDownloadWarnings.mdx index 579f1b9..f6499ed 100644 --- a/src/content/docs/reference/policies/ExemptDomainFileTypePairsFromFileTypeDownloadWarnings.mdx +++ b/src/content/docs/reference/policies/ExemptDomainFileTypePairsFromFileTypeDownloadWarnings.mdx @@ -23,6 +23,14 @@ This policy is based on the [Chrome policy](https://chromeenterprise.google/poli +## Values + +Each entry in the list accepts the following keys: + +- `file_extension`: The file extension the exemption applies to, without a leading dot, such as `jnlp`. +- `domains`: A list of domains the exemption applies to, such as `example.com`. + These are domains, not URL patterns, and a wildcard (`*`) is not supported. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/ExtensionUpdate.mdx b/src/content/docs/reference/policies/ExtensionUpdate.mdx index 83e8437..1a5c9d9 100644 --- a/src/content/docs/reference/policies/ExtensionUpdate.mdx +++ b/src/content/docs/reference/policies/ExtensionUpdate.mdx @@ -17,6 +17,11 @@ Control extension updates. +## Values + +- Set to `true` to leave extension updates enabled. This is the same as not setting the policy. +- Set to `false` to stop extensions updating, and prevent the user from turning updates back on. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/FirefoxSuggest.mdx b/src/content/docs/reference/policies/FirefoxSuggest.mdx index 6f9d024..b6e15e7 100644 --- a/src/content/docs/reference/policies/FirefoxSuggest.mdx +++ b/src/content/docs/reference/policies/FirefoxSuggest.mdx @@ -18,6 +18,16 @@ As of Firefox 146, `WebSuggestions` turns off Suggest completely. +## Values + +- `WebSuggestions`: Set to `false` to turn off Firefox Suggest. +- `SponsoredSuggestions`: Set to `false` to stop sponsored suggestions appearing. +- `OnlineEnabled`: Set to `false` to limit Firefox Suggest to suggestions stored locally, rather than fetched as the user types. +- `ImproveSuggest`: Deprecated, use `OnlineEnabled` instead. +- `Locked`: Prevents the user from changing these settings. + +Values are applied as defaults that users can change, unless `Locked` is set to `true`. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/GoToIntranetSiteForSingleWordEntryInAddressBar.mdx b/src/content/docs/reference/policies/GoToIntranetSiteForSingleWordEntryInAddressBar.mdx index cd8a777..d105de8 100644 --- a/src/content/docs/reference/policies/GoToIntranetSiteForSingleWordEntryInAddressBar.mdx +++ b/src/content/docs/reference/policies/GoToIntranetSiteForSingleWordEntryInAddressBar.mdx @@ -17,6 +17,11 @@ Whether to always go through the DNS server before sending a single word search +## Values + +- Set to `true` to send a single word entry to the DNS server before the search engine, and lock the setting. +- Set to `false` to send a single word entry straight to the search engine, and lock the setting. + ## Description If the site exists, it will navigate to the website. diff --git a/src/content/docs/reference/policies/HardwareAcceleration.mdx b/src/content/docs/reference/policies/HardwareAcceleration.mdx index 5bd4baa..5d3d858 100644 --- a/src/content/docs/reference/policies/HardwareAcceleration.mdx +++ b/src/content/docs/reference/policies/HardwareAcceleration.mdx @@ -17,6 +17,11 @@ Control hardware acceleration. +## Values + +- Set to `true` to leave hardware acceleration enabled. This is the same as not setting the policy. +- Set to `false` to disable hardware acceleration, and prevent the user from turning it back on. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/HttpAllowlist.mdx b/src/content/docs/reference/policies/HttpAllowlist.mdx index 8e71e59..76a4b18 100644 --- a/src/content/docs/reference/policies/HttpAllowlist.mdx +++ b/src/content/docs/reference/policies/HttpAllowlist.mdx @@ -18,6 +18,12 @@ The sites are specified as a list of origins. +## Values + +`HttpAllowlist` expects a list of origins that are not upgraded to HTTPS, such as `http://example.org`. +Each entry is a scheme, hostname and optional port. +Paths and wildcards are not supported. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/IPProtectionAvailable.mdx b/src/content/docs/reference/policies/IPProtectionAvailable.mdx index 692e309..b4a7c11 100644 --- a/src/content/docs/reference/policies/IPProtectionAvailable.mdx +++ b/src/content/docs/reference/policies/IPProtectionAvailable.mdx @@ -17,6 +17,11 @@ Prevent the built-in VPN from being available to users. +## Values + +- Set to `true` to leave the built-in VPN available. This is the same as not setting the policy. +- Set to `false` to make the built-in VPN unavailable to users. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/LegacyProfiles.mdx b/src/content/docs/reference/policies/LegacyProfiles.mdx index 78d9907..ffb96cb 100644 --- a/src/content/docs/reference/policies/LegacyProfiles.mdx +++ b/src/content/docs/reference/policies/LegacyProfiles.mdx @@ -31,6 +31,11 @@ Windows only, GPO only. } ``` +## Values + +- Set to `true` to share one profile across every installation, the same as the `MOZ_LEGACY_PROFILES` environment variable. +- Set to `false` to create a separate profile for each installation. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabled.mdx b/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabled.mdx index 011e475..63dff06 100644 --- a/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabled.mdx +++ b/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabled.mdx @@ -19,6 +19,13 @@ If this policy is set to true, it reverts all cookies to legacy SameSite behavio +## Values + +- Set to `true` to treat cookies with no `SameSite` attribute as `SameSite=None`. +- Set to `false` to treat them as `SameSite=Lax`. + +The policy sets the default behavior rather than locking it, so a user can still change it. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabledForDomainList.mdx b/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabledForDomainList.mdx index c0fc55e..c7760d7 100644 --- a/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabledForDomainList.mdx +++ b/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabledForDomainList.mdx @@ -19,6 +19,13 @@ If this policy is set to true, cookies set for domains in this list will revert +## Values + +`LegacySameSiteCookieBehaviorEnabledForDomainList` expects a list of domains, such as `example.org`. +Cookies set for those domains revert to legacy `SameSite` behavior. + +The policy sets the default behavior rather than locking it, so a user can still change it. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/LocalFileLinks.mdx b/src/content/docs/reference/policies/LocalFileLinks.mdx index 36b69a1..c6363b2 100644 --- a/src/content/docs/reference/policies/LocalFileLinks.mdx +++ b/src/content/docs/reference/policies/LocalFileLinks.mdx @@ -23,6 +23,11 @@ Intranet applications may need this, for example, to link to files on a shared d +## Values + +`LocalFileLinks` expects a list of origins allowed to link to `file:///` URLs, such as `http://example.org/`. +Each origin is a scheme, hostname and optional port. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/ManagedBookmarks.mdx b/src/content/docs/reference/policies/ManagedBookmarks.mdx index 99756aa..49d8c56 100644 --- a/src/content/docs/reference/policies/ManagedBookmarks.mdx +++ b/src/content/docs/reference/policies/ManagedBookmarks.mdx @@ -10,11 +10,6 @@ The bookmarks are only added as a button on the personal toolbar, they are not i The syntax of this policy is based on the [Chrome ManagedBookmarks policy](https://cloud.google.com/docs/chrome-enterprise/policies/?policy=ManagedBookmarks), with the addition of the Firefox-specific `favicon` property. -A `favicon` can be specified for each bookmark. -The value must be a `data:`, `http:`, or `https:` URL. - -A bookmark's `url` can be a `javascript:` URL to create a bookmarklet. - ## Compatibility @@ -28,6 +23,20 @@ A bookmark's `url` can be a `javascript:` URL to create a bookmarklet. +## Values + +The first entry in the list names the toolbar folder, and the entries after it are the bookmarks: + +- `toplevel_name`: The name of the folder button added to the bookmarks toolbar. + Only used in the first entry. +- `name`: The name shown for a bookmark or folder. +- `url`: The address the bookmark opens. + A `javascript:` URL creates a bookmarklet. +- `favicon`: The URL of an icon to show for the bookmark. + Must be a `data:`, `http:` or `https:` URL. +- `children`: A list of bookmarks to put in a folder. + Folders can be nested. + ## Windows (GPO) Software\Policies\Mozilla\Firefox\ManagedBookmarks (REG_MULTI_SZ) = diff --git a/src/content/docs/reference/policies/ManualAppUpdateOnly.mdx b/src/content/docs/reference/policies/ManualAppUpdateOnly.mdx index 386a14d..6ae6b45 100644 --- a/src/content/docs/reference/policies/ManualAppUpdateOnly.mdx +++ b/src/content/docs/reference/policies/ManualAppUpdateOnly.mdx @@ -26,6 +26,11 @@ This policy is primarily intended for advanced end users, not for enterprises, b +## Values + +- Set to `true` to switch to manual updates only. +- Set to `false` to leave automatic update checking enabled. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/MicrosoftEntraSSO.mdx b/src/content/docs/reference/policies/MicrosoftEntraSSO.mdx index 4832b70..cf749ed 100644 --- a/src/content/docs/reference/policies/MicrosoftEntraSSO.mdx +++ b/src/content/docs/reference/policies/MicrosoftEntraSSO.mdx @@ -21,6 +21,11 @@ For the Windows equivalent, see the [`WindowsSSO`](/reference/policies/windowsss +## Values + +- Set to `true` to enable single sign-on for Microsoft Entra accounts, and lock the setting. +- Set to `false` to disable single sign-on for Microsoft Entra accounts, and lock the setting. + ## macOS ```xml diff --git a/src/content/docs/reference/policies/NetworkPrediction.mdx b/src/content/docs/reference/policies/NetworkPrediction.mdx index d465b90..fa95e6e 100644 --- a/src/content/docs/reference/policies/NetworkPrediction.mdx +++ b/src/content/docs/reference/policies/NetworkPrediction.mdx @@ -17,6 +17,11 @@ Enable or disable network prediction ([DNS prefetching](https://developer.mozill +## Values + +- Set to `true` to allow DNS prefetching, and lock the setting. +- Set to `false` to stop DNS prefetching, over both HTTP and HTTPS, and lock the setting. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/NewTabPage.mdx b/src/content/docs/reference/policies/NewTabPage.mdx index 820e1c5..3d04b19 100644 --- a/src/content/docs/reference/policies/NewTabPage.mdx +++ b/src/content/docs/reference/policies/NewTabPage.mdx @@ -23,6 +23,11 @@ To keep the New Tab page but change which sections appear on it, use the [`Firef +## Values + +- Set to `true` to open Firefox Home on new tabs, and lock the setting. +- Set to `false` to open a blank page on new tabs, and lock the setting. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/NoDefaultBookmarks.mdx b/src/content/docs/reference/policies/NoDefaultBookmarks.mdx index 2fd23d6..f5c1d6e 100644 --- a/src/content/docs/reference/policies/NoDefaultBookmarks.mdx +++ b/src/content/docs/reference/policies/NoDefaultBookmarks.mdx @@ -19,6 +19,11 @@ This policy is only effective if the user profile has not been created yet. +## Values + +- Set to `true` to stop Firefox creating the default bookmarks. +- Set to `false` to create the default bookmarks. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/OfferToSaveLogins.mdx b/src/content/docs/reference/policies/OfferToSaveLogins.mdx index 73bb399..3efdf6f 100644 --- a/src/content/docs/reference/policies/OfferToSaveLogins.mdx +++ b/src/content/docs/reference/policies/OfferToSaveLogins.mdx @@ -17,6 +17,11 @@ Control whether or not Firefox offers to save passwords. +## Values + +- Set to `true` to offer to save logins and passwords, and prevent the user from changing it. +- Set to `false` to stop offering to save logins and passwords, and prevent the user from changing it. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/OfferToSaveLoginsDefault.mdx b/src/content/docs/reference/policies/OfferToSaveLoginsDefault.mdx index 7a07b4c..7983b76 100644 --- a/src/content/docs/reference/policies/OfferToSaveLoginsDefault.mdx +++ b/src/content/docs/reference/policies/OfferToSaveLoginsDefault.mdx @@ -17,6 +17,13 @@ Sets the default value of `signon.rememberSignons` without locking it. +## Values + +- Set to `true` to offer to save logins and passwords by default. The user can still change it. +- Set to `false` to not offer to save logins and passwords by default. The user can still change it. + +If [`OfferToSaveLogins`](/reference/policies/offertosavelogins/) is also set, it takes precedence and `OfferToSaveLoginsDefault` is ignored. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/OverrideFirstRunPage.mdx b/src/content/docs/reference/policies/OverrideFirstRunPage.mdx index 195e916..9b7e388 100644 --- a/src/content/docs/reference/policies/OverrideFirstRunPage.mdx +++ b/src/content/docs/reference/policies/OverrideFirstRunPage.mdx @@ -4,7 +4,7 @@ description: "Override the first run page." category: "Startup" --- -Override the first run page. If the value is an empty string (`""`), the first run page is not displayed. +Override the first run page. The first run page is what Firefox opens the first time a new profile is used, normally the onboarding tour at `about:welcome`. Setting this policy replaces that page and turns the onboarding tour off, so users go directly to the URL you specify. @@ -24,6 +24,14 @@ For the page shown after Firefox updates, see the [`OverridePostUpdatePage`](/re +## Values + +`OverrideFirstRunPage` expects the URL to show the first time a new profile is used: + +- A URL, such as `https://example.com`, replaces the onboarding tour with that page. + Multiple URLs can be separated by a vertical bar (`|`), each opening in its own tab. +- An empty string (`""`) shows no first run page at all. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/OverridePostUpdatePage.mdx b/src/content/docs/reference/policies/OverridePostUpdatePage.mdx index b8e422f..293c9e1 100644 --- a/src/content/docs/reference/policies/OverridePostUpdatePage.mdx +++ b/src/content/docs/reference/policies/OverridePostUpdatePage.mdx @@ -4,7 +4,7 @@ description: "Override the upgrade page." category: "Startup" --- -Override the upgrade page. If the value is an empty string (`""`), no extra pages are displayed when Firefox is upgraded. +Override the upgrade page. The upgrade page, also called the "What's New" page, is the extra tab Firefox opens the first time it starts after updating to a new version. It is normally a page on mozilla.org describing what changed in that release. @@ -23,6 +23,13 @@ For the page shown the first time a new profile is used, see the [`OverrideFirst +## Values + +`OverridePostUpdatePage` expects the URL to show the first time Firefox starts after an update: + +- A URL, such as `https://example.com`, replaces the What's New page with that page. +- An empty string (`""`) shows no page after an update. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PasswordManagerEnabled.mdx b/src/content/docs/reference/policies/PasswordManagerEnabled.mdx index 2e1206d..877f4d5 100644 --- a/src/content/docs/reference/policies/PasswordManagerEnabled.mdx +++ b/src/content/docs/reference/policies/PasswordManagerEnabled.mdx @@ -19,6 +19,11 @@ Remove access to the password manager via preferences and block `about:logins`. +## Values + +- Set to `true` to keep the password manager available and offer to save logins, and lock the setting. +- Set to `false` to block `about:logins`, remove password management from settings, and stop Firefox saving logins. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PasswordManagerExceptions.mdx b/src/content/docs/reference/policies/PasswordManagerExceptions.mdx index 1c4d634..db14292 100644 --- a/src/content/docs/reference/policies/PasswordManagerExceptions.mdx +++ b/src/content/docs/reference/policies/PasswordManagerExceptions.mdx @@ -19,6 +19,12 @@ The sites are specified as a list of origins. +## Values + +`PasswordManagerExceptions` expects a list of origins Firefox never offers to save passwords for, such as `https://example.org`. +Each origin is a scheme, hostname and optional port. +Paths and wildcards are not supported. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PictureInPicture.mdx b/src/content/docs/reference/policies/PictureInPicture.mdx index 07672b1..7fc744c 100644 --- a/src/content/docs/reference/policies/PictureInPicture.mdx +++ b/src/content/docs/reference/policies/PictureInPicture.mdx @@ -17,6 +17,13 @@ Enable or disable [Picture-in-Picture](https://support.mozilla.org/en-US/kb/abou +## Values + +- `Enabled`: Set to `true` to make the Picture-in-Picture toggle available, or `false` to remove it. +- `Locked`: Set to `true` to prevent the user from changing the setting. + +`Enabled` is applied as a default that users can change, unless `Locked` is set to `true`. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PostQuantumKeyAgreementEnabled.mdx b/src/content/docs/reference/policies/PostQuantumKeyAgreementEnabled.mdx index 7ca09c5..72ae194 100644 --- a/src/content/docs/reference/policies/PostQuantumKeyAgreementEnabled.mdx +++ b/src/content/docs/reference/policies/PostQuantumKeyAgreementEnabled.mdx @@ -27,6 +27,11 @@ This policy is independent of [`CNSA2KeyAgreementEnabled`](/reference/policies/c +## Values + +- Set to `true` to enable post-quantum key agreement for TLS, HTTP/3 and WebRTC, and lock the settings. +- Set to `false` to disable post-quantum key agreement for TLS, HTTP/3 and WebRTC, and lock the settings. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PrimaryPassword.mdx b/src/content/docs/reference/policies/PrimaryPassword.mdx index aadbca3..291cbb6 100644 --- a/src/content/docs/reference/policies/PrimaryPassword.mdx +++ b/src/content/docs/reference/policies/PrimaryPassword.mdx @@ -22,6 +22,11 @@ If both `DisableMasterPasswordCreation` and `PrimaryPassword` are used, `Disable +## Values + +- Set to `true` to require a primary password, and stop the user removing it. +- Set to `false` to remove primary password functionality, the same as setting [`DisableMasterPasswordCreation`](/reference/policies/disablemasterpasswordcreation/) to `true`. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PrintingEnabled.mdx b/src/content/docs/reference/policies/PrintingEnabled.mdx index 8d47493..f6d2177 100644 --- a/src/content/docs/reference/policies/PrintingEnabled.mdx +++ b/src/content/docs/reference/policies/PrintingEnabled.mdx @@ -17,6 +17,11 @@ Enable or disable printing. +## Values + +- Set to `true` to allow printing, and lock the setting. +- Set to `false` to disable printing, and lock the setting. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PromptForDownloadLocation.mdx b/src/content/docs/reference/policies/PromptForDownloadLocation.mdx index f72632e..544b628 100644 --- a/src/content/docs/reference/policies/PromptForDownloadLocation.mdx +++ b/src/content/docs/reference/policies/PromptForDownloadLocation.mdx @@ -17,6 +17,11 @@ Ask where to save each file before downloading. +## Values + +- Set to `true` to ask where to save each file, and lock the setting. +- Set to `false` to save files to the download directory without asking, and lock the setting. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/RequestedLocales.mdx b/src/content/docs/reference/policies/RequestedLocales.mdx index b814a59..563fa85 100644 --- a/src/content/docs/reference/policies/RequestedLocales.mdx +++ b/src/content/docs/reference/policies/RequestedLocales.mdx @@ -20,6 +20,16 @@ As of Firefox 68, this can be a string so that you can specify an empty value (` +## Values + +`RequestedLocales` accepts either an array of locale codes or a comma-separated string, in order of preference: + +- `["de", "en-US"]` as an array. +- `"de,en-US"` as a string. + +The first locale with an available language pack becomes active. +The policy is applied when its value changes, so a user who switches language afterwards is not switched back. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SSLVersionMax.mdx b/src/content/docs/reference/policies/SSLVersionMax.mdx index c447524..03c0c39 100644 --- a/src/content/docs/reference/policies/SSLVersionMax.mdx +++ b/src/content/docs/reference/policies/SSLVersionMax.mdx @@ -24,6 +24,15 @@ For setting and locking the minimum version of TLS, see the [`SSLVersionMin`](/r +## Values + +`SSLVersionMax` expects one of the following values: + +- `tls1`: TLS 1.0 +- `tls1.1`: TLS 1.1 +- `tls1.2`: TLS 1.2 +- `tls1.3`: TLS 1.3 + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SSLVersionMin.mdx b/src/content/docs/reference/policies/SSLVersionMin.mdx index 2ddee5f..0ea2959 100644 --- a/src/content/docs/reference/policies/SSLVersionMin.mdx +++ b/src/content/docs/reference/policies/SSLVersionMin.mdx @@ -24,6 +24,15 @@ For setting and locking the maximum version of TLS, see the [`SSLVersionMax`](/r +## Values + +`SSLVersionMin` expects one of the following values: + +- `tls1`: TLS 1.0 +- `tls1.1`: TLS 1.1 +- `tls1.2`: TLS 1.2 +- `tls1.3`: TLS 1.3 + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SearchBar.mdx b/src/content/docs/reference/policies/SearchBar.mdx index 83c938f..c1222a5 100644 --- a/src/content/docs/reference/policies/SearchBar.mdx +++ b/src/content/docs/reference/policies/SearchBar.mdx @@ -17,6 +17,15 @@ Set whether or not the [search bar](https://support.mozilla.org/en-US/kb/add-sea +## Values + +`SearchBar` expects one of the following values: + +- `unified`: Search from the address bar, with no separate search box. +- `separate`: Add a search box to the toolbar, next to the address bar. + +The policy sets the placement rather than forcing it, so a user who moves the search bar afterwards is not moved back. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SearchSuggestEnabled.mdx b/src/content/docs/reference/policies/SearchSuggestEnabled.mdx index f672147..0fa32e9 100644 --- a/src/content/docs/reference/policies/SearchSuggestEnabled.mdx +++ b/src/content/docs/reference/policies/SearchSuggestEnabled.mdx @@ -23,6 +23,11 @@ For the Firefox Suggest results that come from Mozilla rather than from the sear +## Values + +- Set to `true` to show search suggestions in the address bar and search bar, and lock the setting. +- Set to `false` to hide search suggestions, and lock the setting. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/ShowHomeButton.mdx b/src/content/docs/reference/policies/ShowHomeButton.mdx index 8d910a0..7522244 100644 --- a/src/content/docs/reference/policies/ShowHomeButton.mdx +++ b/src/content/docs/reference/policies/ShowHomeButton.mdx @@ -19,6 +19,11 @@ Future versions of Firefox will not show the home button by default. +## Values + +- Set to `true` to add the home button to the toolbar, and stop it being removed by default. +- Set to `false` to remove the home button from the toolbar. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SkipTermsOfUse.mdx b/src/content/docs/reference/policies/SkipTermsOfUse.mdx index 3ea3ea6..2112768 100644 --- a/src/content/docs/reference/policies/SkipTermsOfUse.mdx +++ b/src/content/docs/reference/policies/SkipTermsOfUse.mdx @@ -20,6 +20,11 @@ You represent that you accept and have the authority to accept the Terms of Use +## Values + +- Set to `true` to skip the Terms of Use and Privacy Notice on startup, accepting them on behalf of your users. +- Set to `false` to show the Terms of Use and Privacy Notice. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/StartDownloadsInTempDirectory.mdx b/src/content/docs/reference/policies/StartDownloadsInTempDirectory.mdx index 8aac2dc..c931ccf 100644 --- a/src/content/docs/reference/policies/StartDownloadsInTempDirectory.mdx +++ b/src/content/docs/reference/policies/StartDownloadsInTempDirectory.mdx @@ -17,6 +17,11 @@ Force downloads to start off in a local, temporary location rather than the defa +## Values + +- Set to `true` to download files to a temporary directory before moving them, and lock the setting. +- Set to `false` to download files straight to the download directory, and lock the setting. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/TranslateEnabled.mdx b/src/content/docs/reference/policies/TranslateEnabled.mdx index a80c12c..052b998 100644 --- a/src/content/docs/reference/policies/TranslateEnabled.mdx +++ b/src/content/docs/reference/policies/TranslateEnabled.mdx @@ -21,6 +21,13 @@ If you only want to disable the popup, you can set the `browser.translations.aut +## Values + +- Set to `true` to enable webpage translation, and lock the setting. +- Set to `false` to disable webpage translation, and lock the setting. + +If [`AIControls`](/reference/policies/aicontrols/) sets `Translations` or `Default`, it takes precedence and `TranslateEnabled` is ignored. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/UseSystemPrintDialog.mdx b/src/content/docs/reference/policies/UseSystemPrintDialog.mdx index cf0e7a9..d16a111 100644 --- a/src/content/docs/reference/policies/UseSystemPrintDialog.mdx +++ b/src/content/docs/reference/policies/UseSystemPrintDialog.mdx @@ -20,6 +20,11 @@ If this policy is set to `true`, Firefox skips that panel and opens the operatin +## Values + +- Set to `true` to print using the operating system print dialog instead of the Firefox print preview, and lock the setting. +- Set to `false` to print using the Firefox print preview, and lock the setting. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/VisualSearchEnabled.mdx b/src/content/docs/reference/policies/VisualSearchEnabled.mdx index 3f06ce7..54b8b0b 100644 --- a/src/content/docs/reference/policies/VisualSearchEnabled.mdx +++ b/src/content/docs/reference/policies/VisualSearchEnabled.mdx @@ -20,6 +20,11 @@ It is only offered when Google is the default search engine, so removing Google +## Values + +- Set to `true` to enable visual search, and lock the setting. +- Set to `false` to disable visual search, and lock the setting. + ## Windows (GPO) ```url diff --git a/src/content/docs/reference/policies/WindowsSSO.mdx b/src/content/docs/reference/policies/WindowsSSO.mdx index 57283fb..8a90ee7 100644 --- a/src/content/docs/reference/policies/WindowsSSO.mdx +++ b/src/content/docs/reference/policies/WindowsSSO.mdx @@ -19,6 +19,11 @@ If this policy is set to `true`, Firefox will use credentials stored in Windows +## Values + +- Set to `true` to allow Windows single sign-on for Microsoft, work and school accounts, and lock the setting. +- Set to `false` to stop Windows single sign-on, and lock the setting. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/XSLTEnabled.mdx b/src/content/docs/reference/policies/XSLTEnabled.mdx index 515be55..2deb4e2 100644 --- a/src/content/docs/reference/policies/XSLTEnabled.mdx +++ b/src/content/docs/reference/policies/XSLTEnabled.mdx @@ -17,6 +17,11 @@ Enable or disable support for the [XSLTProcessor](https://developer.mozilla.org/ +## Values + +- Set to `true` to allow XSLT processing, and lock the setting. +- Set to `false` to block XSLT processing, and lock the setting. + ## Windows (GPO) ```