UserMessaging

Prevent Firefox from messaging the user in certain situations.

Firefox shows a number of in-product messages that are unrelated to the page being viewed: recommendations for extensions and features based on the kind of sites visited, suggestions in the address bar, onboarding messages for new profiles, and information about Mozilla products in Settings. This policy turns those off individually, which is usually needed when users are not expected to install their own extensions or see product information.

Each message-specific key covers one type of message, so setting one does not affect the others.

Compatibility

Firefox	Firefox ESR	Firefox Enterprise
Available since 75	Available since 68.7.0	Not supported

CCK2 Equivalent: N/A
OMA-URI: UserMessaging
Preferences Affected: browser.newtabpage.activity-stream.asrouter.userprefs.cfr.addons, browser.newtabpage.activity-stream.asrouter.userprefs.cfr.features, browser.aboutwelcome.enabled, browser.preferences.moreFromMozilla, browser.preferences.experimental

Examples

{
  "policies": {
    "UserMessaging": {
      "ExtensionRecommendations": false,
      "FeatureRecommendations": false,
      "UrlbarInterventions": false,
      "SkipOnboarding": true,
      "MoreFromMozilla": true,
      "FirefoxLabs": false,
      "Locked": true
    }
  }
}

JSON schema

{
  "type": "object",
  "properties": {
    "WhatsNew": {
      "type": "boolean"
    },
    "ExtensionRecommendations": {
      "type": "boolean"
    },
    "FeatureRecommendations": {
      "type": "boolean"
    },
    "UrlbarInterventions": {
      "type": "boolean"
    },
    "SkipOnboarding": {
      "type": "boolean"
    },
    "MoreFromMozilla": {
      "type": "boolean"
    },
    "FirefoxLabs": {
      "type": "boolean"
    },
    "Locked": {
      "type": "boolean"
    }
  }
}

Values

WhatsNew: Remove the "What's New" icon and menuitem. (Deprecated)
ExtensionRecommendations: If false, don't recommend extensions while the user is visiting web pages.
FeatureRecommendations: If false, don't recommend browser features.
UrlbarInterventions: If false, don't offer Firefox specific suggestions in the URL bar.
SkipOnboarding: If true, don't show onboarding messages on the new tab page. The OverrideFirstRunPage policy also turns onboarding off, and locks it.
MoreFromMozilla: If false, don't show the "More from Mozilla" section in Preferences. (Firefox 98)
FirefoxLabs: If false, don't show the "Firefox Labs" section in Preferences. (Firefox 130.0.1)
Locked: Prevents the user from changing user messaging preferences.

Windows (GPO)

Software\Policies\Mozilla\Firefox\UserMessaging\ExtensionRecommendations = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\UserMessaging\FeatureRecommendations = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\UserMessaging\UrlbarInterventions = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\UserMessaging\SkipOnboarding = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\UserMessaging\MoreFromMozilla = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\UserMessaging\FirefoxLabs = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\UserMessaging\Locked = 0x1 | 0x0

macOS

<dict>
  <key>UserMessaging</key>
  <dict>
    <key>ExtensionRecommendations</key>
    <true/> | <false/>
    <key>FeatureRecommendations</key>
    <true/> | <false/>
    <key>UrlbarInterventions</key>
    <true/> | <false/>
    <key>SkipOnboarding</key>
    <true/> | <false/>
    <key>MoreFromMozilla</key>
    <true/> | <false/>
    <key>FirefoxLabs</key>
    <true/> | <false/>
    <key>Locked</key>
    <true/> | <false/>
  </dict>
</dict>