Skip to main content
Browse documentation

Product

Alerts

Alerts is the feed of visibility, sentiment and site-health changes worth your attention, with an unread count so you can tell at a glance whether anything happened.

The six change kinds

Underneath the feed is a stream of change events. Each one carries a kind, and the kind is what everything downstream — the feed line, the email, the webhook — is keyed on.

KindMeaning
Visibility gainedYou started appearing where you previously did not.
Visibility droppedYou stopped appearing where you previously did.
Rank improvedYou are being placed higher in answers.
Rank droppedYou are being placed lower.
Citations gainedNew URLs of yours are being cited.
Citations lostURLs that used to be cited no longer are.

What each person sees

The feed is scoped by workspace membership and role, so a member does not see events for brands they have no access to. It is one feed per person, not one feed per workspace shown to everybody.

Email preferences

Email notification preferences are stored per member and per change kind, so one person can follow visibility drops while another follows citations. A member with no preferences set yet receives the default rather than silence.

Sending changes somewhere else

The same events drive webhooks. Each webhook endpoint subscribes to the kinds it wants, using event names of the form change_event.visibility_dropped. Endpoints created before per-kind subscriptions existed carry the catch-all change_event.created and continue to receive every kind.

Alerts are derived from sampled data, so an event describes a change in what the models said, over the samples taken. Alongside a real drop, check the sample size: a thin sampling window moves the numbers around on its own.