Onboarding flow comprises of entire flow users have after Firefox has successfully been installed or upgraded.
For new users, the first instance of new tab shows relevant messaging on about:welcome. For existing users, an upgrade dialog with release highlights is shown on major release upgrades.
New User Onboarding¶
A full-page multistep experience that shows up on first run since Fx80 with
browser.aboutwelcome.enabled pref as
false takes user to about:newtab and hides about:welcome.
Multistage proton onboarding experience is live since Fx89 and its major variations are:
No about:welcome experience is shown (users see about:newtab during first run).
Testing instructions: Set
false in about:config
A full-page multistep experience that shows a large splash screen and several subsequent screens. See Default experience variations for more information.
Return to AMO (RTAMO)¶
Special custom onboarding experience shown to users when they try to download an addon from addons.mozilla.org but don’t have Firefox installed. This experience allows them to install the addon they were trying to install directly from a button on RTAMO.
Note that this uses attribution data added to the browser during the download process, which is only currently implemented for Windows.
Set pref browser.newtabpage.activity-stream.asrouter.devtoolsEnabled as true
Click Targeting -> Attribution -> Force Attribution
Open about:welcome, should display RTAMO page
Run experiments and roll-outs through Nimbus (see FeatureManifests), only windows is supported. FeatureConfig (from prefs or experiments) has higher precedence to defaults. See Default experience variations
about:welcome only shows up for users who download Firefox Beta or release (currently not enabled on Nightly)
Enterprise builds can turn off about:welcome by setting the browser.aboutwelcome.enabled preference to false.
Default experience variations¶
In order of precedence:
Has AMO attribution
Return to AMO
Proton default content with below screens
Welcome Screen with option to ‘Pin Firefox’, ‘Set default’ or ‘Get Started’
Import screen allows user to import password, bookmarks and browsing history from previous browser.
Set a theme lets users personalize Firefox with a theme.
Upgrade Dialog was first introduced in Fx89 with MR1 release. It replaces whatsnew tab with an upgrade modal explaining proton changes, setting Firefox as default and/or pinning, and allowing theme change.
Hides whatsnew tab on release channel when Upgrade Modal is shown
Modal dialog appears on major version upgrade to 89 for MR1
It’s a window modal preventing access to tabs and other toolbar UI
Support desired content and actions on each screen. For MR1 initial screen explains proton changes, highlight option to set Firefox as default and pin. Subsequent screen allows theme changes.
In about:config, set:
88.0. The dialog only shows after it detects a major upgrade and need to set to 88 to trigger MR1 upgrade dialog.
browser.startup.upgradeDialog.versionis empty. After the dialog shows,
browser.startup.upgradeDialog.versionremembers what version of the dialog to avoid reshowing.