Documentation

get_section_visibility

Which page sections visitors actually saw, how much of each was visible, and for how long.

When to use it

To find content nobody reaches. A section with a low percent_visible is either too far down, inside a closed accordion, or behind a tab visitors do not click.

Ask for it like this

You do not name the tool. These are questions that make an assistant reach for it:

Does anyone see my reviews section?
Which parts of my product page get ignored?

Parameters

url
string
Restrict to pages containing this string.

Shared parameters it accepts

Documented in full on the tool reference index.

Date window — defaults to the last 30 days.

dateFrom
stringdefault: 30 days ago
Start of the window, YYYY-MM-DD. Inclusive.
dateTo
stringdefault: today
End of the window, YYYY-MM-DD. Inclusive.

Session filters — narrow the result to one audience.

device
enum
Keep only sessions on this device class.
mobiletabletdesktop
visitorType
enum
Keep only first-time or only returning visitors.
newreturning
utmSource
string
Keep only sessions from this UTM source, for example google.
utmMedium
string
Keep only sessions from this UTM medium, for example cpc.
utmCampaign
string
Keep only sessions from this UTM campaign name.
theme
string
Keep only sessions that rendered this Shopify theme id (bare numeric id). Use it to isolate one arm of a theme A/B test. Sessions recorded before 7 August 2026 carry no theme id and drop out.

Every tool also accepts merchantId, which resolves from your connection. You never pass it.

What comes back

JSON. These are the top-level keys; date-scoped tools additionally carry a _meta block with the server date and the data coverage envelope.

sections
Per section: occurrences, avg_percent_visible and avg_visible_duration_ms.

Pairs with