runtime.OnInstalledReason

Type

Values of this type are strings. Possible values are:

"install": The extension was installed.
"update": The extension was updated to a new version.
"browser_update" or, for Chrome, "chrome_update": The browser was updated to a new version.
"shared_module_update": Another extension, which contains a module used by this extension, was updated.

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Firefox for Android	Safari on iOS
`OnInstalledReason`	Chrome – Full support Chrome 58 (Release date: 2017-04-19) footnote footnote Uses 'chrome_update' instead of 'browser_update'.	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote footnote Uses 'chrome_update' instead of 'browser_update'.	Firefox – Full support Firefox 45 (Release date: 2016-03-08) footnote Full support	Opera – Full support Opera 45 (Release date: 2017-05-10) footnote footnote Uses 'chrome_update' instead of 'browser_update'.	Safari – Full support Safari 14 (Release date: 2020-09-16) footnote footnote Only supports 'install' and 'update'.	Firefox for Android – Full support Firefox for Android 48 (Release date: 2016-08-02) footnote Full support	Safari on iOS – Full support Safari on iOS 15 (Release date: 2021-09-20) footnote footnote Only supports 'install' and 'update'.

Tip: you can click/tap on a cell for more information.

Note: This API is based on Chromium's chrome.runtime API. This documentation is derived from runtime.json in the Chromium code.

This page was last modified on Jul 17, 2025 by MDN contributors.

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.