User Guide

How to Use
GAStat

Set up widgets, use AI Analyst, and get the most out of your GA4 data.

1

Enter Home Screen Edit Mode

  • On your iPhone, long-press on an empty area of the Home Screen until the icons start to jiggle.
  • Tap the "+" button in the top-left or top-right corner to open the widget gallery.
2

Find GAStat in the Widget Gallery

  • In the search bar at the top, type "GAStat" to find the app's widgets.
3

Choose a Widget

GAStat offers several widget types. All widgets require a Pro subscription.

Home Screen

Real-Time Users — Small & Medium

Live active user count with a sparkline chart. You can add multiple widgets, each showing a different GA property.

Home Screen

Multi-Property — Large

Compare up to 6 properties side by side on a single large widget.

Home Screen

Events

Monitor real-time event counts for your most important actions.

Home Screen

Yesterday

Yesterday's active user totals at a glance, every morning.

4

Add the Widget to Your Home Screen

  • Select your preferred widget size and tap "Add Widget".
  • Drag it to your desired position.
  • Tap "Done" to exit edit mode.
5

Add a Widget to Your Lock Screen

GAStat supports two Lock Screen widget sizes — check your real-time user count without even unlocking your phone.

Lock Screen

Circular

Real-time active user count displayed as a compact circular widget below the clock.

Lock Screen

Rectangular

Property name and real-time user count in a wider format, ideal for a quick read.

How to add:

  • Wake your iPhone and long-press on the lock screen until the "Customize" button appears at the bottom.
  • Tap "Customize", then select "Lock Screen".
  • Tap the widget area below the clock to open the widget picker.
  • Search for "GAStat" and choose Circular or Rectangular.
  • Tap "Done" to save.
Lock Screen Widgets require iOS 16 or later.
6

Select a GA Property for Your Widget

  • Long-press a GAStat widget and tap "Edit Widget".
  • Select the GA property you want to display.
  • You can add multiple Small Widgets, each configured to a different GA property, so you can monitor several sites at once.
7

Using the Widgets

  • Widgets update periodically to show your latest analytics data.
8

Using AI Analyst

AI Analyst lets you ask questions about your Google Analytics data in natural language and get AI-powered insights.

  • Open a GA property from the app's main screen, then tap AI Analyst.
  • Choose a preset question or type your own (e.g., "How did my key GA4 metrics change over the last 7 days?").
  • AI Analyst will query your analytics data and return a summary with supporting evidence.
  • Successful analyses are saved on your device for 30 days and can be reviewed from History.

About AI Credits:

  • Every user gets 1 free trial credit.
  • Additional credits can be purchased as credit packs inside the app.
  • Purchased credits never expire and are consumed on a first-purchased-first-used basis.
9

Troubleshooting & FAQs

Can't find GAStat widgets?

Make sure GAStat is installed and updated. Your device must run iOS 17.6 or later.

Widget data not updating?

Open GAStat to refresh your session and check your login status. If the issue persists, try removing and re-adding the widget, or restart your device.

Lock Screen Widget showing a lock icon?

Lock Screen Widgets are available to Pro subscribers only. Upgrade inside the GAStat app to unlock them.

How do I remove a widget?

Long-press the widget and select "Remove Widget".

Additional Tips

  • Combine multiple Small Widgets to keep an eye on different GA properties at the same time.
  • Use the Large Widget for a quick overview of multiple GA properties in one place.
  • Add a Lock Screen Widget to check your real-time user count without unlocking your phone.