Cohort Insights
Support

How can we help?

Cohort Insights is a small, focused app. If something isn't working — or you've got a feature you'd love to see — we'd genuinely like to hear from you.

Email support

Best for bug reports, account issues, and anything sensitive.

support@cohortinsights.com →

Feature requests

Got an idea? Tell us what would make Cohort Insights better for the way you work.

feedback@cohortinsights.com →

Common questions

Quick answers to the questions we get most.

Jump to FAQ →

Frequently asked questions

Which versions of macOS does Cohort Insights support?

macOS 14 Sonoma or later, on Apple Silicon and Intel Macs. We prioritize the latest macOS release because the app uses recent SwiftUI APIs.

What permissions does the app need?

Just outgoing network access (to reach Google's APIs) and Keychain access (to securely store your sign-in tokens). The app is sandboxed and does not request file-system or hardware access.

I signed in with Google but I don't see any properties.

Cohort Insights shows the GA4 properties your Google account has access to. If the list is empty, double-check that:

  • You signed in with the Google account that owns or has been granted access to your GA4 properties.
  • You have GA4 (Google Analytics 4) properties, not just legacy Universal Analytics. UA properties cannot be queried via the GA4 Data API.
  • You haven't revoked the app's access on your Google permissions page.

Why are some metrics not updating in real time?

The GA4 Data API is metered per property per day. To stay within quota, the app caches non-realtime reports and refreshes them on a timer (60 seconds in the main window, 60 minutes for the desktop widget, with a 15-minute minimum). The Realtime tab uses Google's separate realtime quota and is always live.

The widget shows stale numbers.

The widget renders from a shared cache that refreshes in the background. If you've just signed in or just switched the selected property, give the widget a minute to pick up the change. You can force a refresh by opening the main app — its refresh updates the shared cache that the widget reads from.

I'm getting "rate limited" or 429 errors.

Google enforces a per-property daily quota on the GA4 Data API. If you hit it, the app surfaces the error and waits. Closing the app will not reset your quota — Google does that automatically each day. If this happens often, let us know which workflow triggered it and we'll look at the request pattern.

Does Cohort Insights work offline?

Partially. The main window needs a network connection to fetch fresh data, but the desktop widget and menu bar extra will continue to show the most recent cached values when offline.

How do I revoke the app's access to my Google account?

Visit your Google Account permissions page and remove Cohort Insights. You should also sign out from within the app's Settings to clear your local Keychain tokens.

Where do I report a bug?

Email support@cohortinsights.com with:

  • Your macOS version and Mac model (Apple menu → About This Mac).
  • The app version (Cohort Insights → About Cohort Insights).
  • Steps to reproduce the issue.
  • Screenshots if relevant.

System requirements

  • macOS: 14 Sonoma or later
  • CPU: Apple Silicon or Intel (universal binary)
  • Google account with access to at least one GA4 property
  • Network: outgoing HTTPS access to Google APIs