Frequently Asked Questions

FAQ

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.

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 yet. The currently supported versions are Umbraco 10–13, and we are working on compatibility with the newer Umbraco majors.

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?

We did not get enough interest to continue developing the Matomo connector. If you are interested in Matomo support, please contact us.

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.