Monitoring extension usage statistics

Learn how to use the built-in dashboard on addons.mozilla.org (AMO) to monitor usage statistics for your extension.

Developers can use the statistics dashboard feature on addons.mozilla.org (AMO) to find more information related to their extension’s usage. These stats are aggregated from Firefox telemetry data and do not include any personally identifiable user data. This information provides developers with more information about user adoption, general demographics, and other insights that might help them make changes or improvements.

Accessing the statistics dashboard

Each extension’s dashboard is private and can only be accessed by authors and owners of the extension.

The easiest way to access the dashboard is to sign in to AMO and navigate to “Manage My Submissions.” You can find a link to the statistics dashboard under the name of the add-on it is associated with.

Screenshot of an add-on on the Manage My Submissions page; below the add-on name is a link titled Statistics

Tracking external sources

If you link to your add-on’s listing page or directly to its file from an external site, such as your blog or website, you can append the following standard UTM parameters to be tracked as additional sources on your download statistics dashboard:

Parameter Description Example
utm_source The name of the product, domain of the website that drives traffic to the link. utm_source=email
utm_medium The channel you are using to share your link. utm_medium=social
utm_content The specific item that a person clicks on to access the link (such as an A/B test, a website banner, or a specific ad). utm_content=get-the-addon-button
utm_campaign The specific product promotion or strategic campaign. utm_campaign=launch-announcement

All of these parameters are optional. The statistics dashboard includes a view that breaks down downloads by each of these parameters, so you can use any or all of them. You can also use a tool like Campaign URL Builder by Google to create your UTM parameters.

There is a limit of 40 characters for each UTM parameter value. Longer values will be truncated.

Add-on listing example

Below is an example of a link to your add-on's listing page with UTM parameters:

https://addons.mozilla.org/addon/firefox-color?utm_source=mysite.wordpress.com&utm_medium=blog&utm_content=top-banner&campaign=get-my-addons