Frequently Asked Questions

FAQ

Legacy package

These questions cover the legacy Google Analytics for Umbraco package (Flowcourier.Umbraco.Analytics, Umbraco 10–13), which is deprecated. On Umbraco 17.5+ use Flowcourier Analytics with the Google Analytics provider — there is a migration page.

Can I use the free license for a commercial project?

Yes, you can use the free license for a commercial project.

When you install the extension without providing a license, it runs in Free Edition mode by default. This includes a 30-day data view limit. If you want access to additional features such as filters, you need to upgrade to the Paid License — see the Google Analytics for Umbraco page for pricing. A valid license key will be provided upon purchase.

The successor on Umbraco 17.5+ has no licence file and no 30-day limit: all traffic reports are free, and only AI Visibility (Analytics Pro) takes a key.

If you experience issues, please contact us at [email protected].

Can I run the extension on localhost or in headless environments?

Yes. The extension works regardless of where Umbraco is running — whether it’s http://localhost, https://staging.mysite.com, or https://intranet.

What matters is the base URL configured in Google Analytics, not the Umbraco domain itself. This design supports local development, internal use, staging, test, and headless setups.

For example:

• You have Umbraco running on http://localhost/
• Your Google Analytics is tracking https://www.example.com/

In this case, your Umbraco home node http://localhost/ maps to the GA view of https://www.example.com/. To view stats for https://www.example.com/my-page, simply create a matching Umbraco page at http://localhost/my-page.

Does the extension support Umbraco 14-17?

Not this package: it supports Umbraco 10–13 and is deprecated. Its successor for Umbraco 17.5+ is Flowcourier.Umbraco.GoogleAnalytics, the Google Analytics provider for Flowcourier Analytics — configuration only, no licence file, and the same backoffice views the Matomo provider gets. See Migrating from the legacy package.

Can I request a feature?

Yes! Please open an issue on GitHub at https://github.com/flowcourier/Flowcourier.Umbraco.Support.

What happened to Matomo support?

It lives in the successor: Flowcourier Analytics on Umbraco 17.5+ takes either the Matomo or the Google Analytics provider behind the same dashboards. The legacy package never shipped a Matomo connector.

I get an “Invalid grant” error message — what should I check?

• Your service account has the correct role (Editor or Owner).
• You have created the service account under the same Google account you use for Google Analytics.
• The local time is in sync with the server time (the maximum admissible difference is 5 minutes).

Statistics are not loading, and the browser inspector shows 500 errors on requests

1. Double-check that you have pasted the complete JSON key into the credentials field in Umbraco Settings.
2. Test the credentials against an empty Umbraco installation. You can set one up quickly with:

dotnet new install Umbraco.Templates::13.*
dotnet new umbraco -n "v13"
cd v13
dotnet add package Clean --version 4.*
dotnet add package Flowcourier.Umbraco.Analytics --version 13.1.0-rc1
dotnet run

Then add your Google service account credentials under the Settings area and check that analytics loads on the home node.

• If it doesn’t load, the problem is with your Google credentials or Google Analytics configuration.
• If it does load, the problem is likely a customization in your own Umbraco site. Check the Umbraco logs for a more detailed error message, and consider whether the project uses a custom JSON serializer — that is a common culprit.

Still stuck? Open an issue at https://github.com/flowcourier/Flowcourier.Umbraco.Support.