MerchantFlowMerchantFlow Docs
Dashboard

Anomaly Alerts for E-commerce

Get proactive alerts when your store deviates from baseline - revenue drops, ROAS shifts, sync failures, and credential expirations - without watching dashboards all day.

Anomaly Alerts

Anomaly alerts are proactive notifications surfaced when MerchantFlow detects that your store's metrics or sync state has deviated meaningfully from baseline - a revenue drop, an unexpected ROAS shift, a failing integration, or an expiring credential. They show up in the in-app Notifications panel and the Daily Email Summary so issues catch your eye before they become problems.

Plan availability: Anomaly alerts are included on the Pro and Plus tiers. Starter workspaces do not receive anomaly alerts. See Pricing Plans.

What Triggers an Alert

The anomaly engine sweeps tenant data on a schedule and fires alerts in these categories:

CategoryExample trigger
RevenueDay-over-day or period-over-period drop beyond the typical variance
ROASA connected ad channel's ROAS drops well below your trailing average
Ad spendSudden spike in spend without a matching revenue lift
Profit marginNet margin compression beyond a threshold
Sync healthA sync job has failed repeatedly, or hasn't run within its expected window
CredentialsAn OAuth credential is approaching expiry or has been revoked by the provider
FulfillmentUnfulfilled order backlog above normal levels
Data qualityCOGS or attribution coverage drops below a threshold for active products

Where Alerts Appear

Anomaly alerts surface in three places, so the same finding catches you whether you're in the app or in your inbox:

  1. In-app notifications dropdown in the dashboard header (bell icon) - see Notifications
  2. Daily AI Email Summary in the Operational Alerts section if you have it enabled - see Email Summary
  3. AI Insights panel on the main dashboard - severe alerts surface as warning or negative insight cards - see AI Insights

How Detection Works

The anomaly engine compares each metric against its trailing baseline (a rolling window of the same period type) and flags deviations that fall outside the expected range. Sync-health and credential alerts are deterministic - they fire whenever a job has failed N times in a row or a credential is N days from expiry. Data-quality alerts fire when coverage thresholds drop below the configured floor.

Detection runs in the background on a schedule. The engine ships with defaults tuned to typical e-commerce variance, and you can tune how alerts are emailed - sensitivity, severity floor, quiet hours, and weekend behavior - from Settings > Notifications (see below).

Configuring Anomaly Alerts

Email delivery of anomaly alerts is configurable from the Anomaly Alerts card at Settings > Notifications (/dashboard/settings/notifications). Critical alerts arrive immediately; warnings batch into a morning digest in your store timezone.

Plan availability: The Anomaly Alerts card requires the Pro or Plus tier. On Starter, the card shows an upgrade prompt instead of the controls.

ControlWhat it doesDefault
Master toggleTurns anomaly alert emails on or off entirelyOn
Severity floorSkips emails below the chosen level: Critical only, Critical and warning, or All anomaliesCritical and warning
ThresholdAn anomaly only emails if the metric is at least this far outside its baseline (5% to 100%, in 5% steps)30%
Quiet hoursNo emails during the chosen window, in your store timezone. Critical alerts queue and arrive at the next open windowOff
Weekend deliveryWhen off, only critical alerts are sent on Saturdays and SundaysOff (critical-only weekends)

Tuning the threshold: smaller stores with naturally volatile day-to-day numbers often raise the threshold to 40-50% to cut noise; larger, more stable stores often lower it to 15-20% to catch subtler shifts.

Acting on an Alert

Each alert links to the relevant dashboard page where you can investigate:

  • Revenue/profit alerts → main dashboard with the affected timeframe pre-selected
  • ROAS / ad-spend alerts → the Ads page for the affected channel
  • Sync health alertsSync Status for the failing job
  • Credential alertsSettings > Integrations (/dashboard/settings/integrations) to reconnect

Frequently Asked Questions

Can I configure anomaly thresholds?

Yes. The Anomaly Alerts card at Settings > Notifications lets you set the deviation threshold (5-100%, default 30%), a severity floor, quiet hours, and weekend delivery behavior. See Configuring Anomaly Alerts above.

Why am I not getting alerts?

Most likely reasons:

  1. You're on the Starter tier - anomaly alerts require Pro or Plus. See Pricing Plans.
  2. You haven't accumulated enough history yet - the engine needs a baseline to compare against.
  3. Your Anomaly Alerts settings may be filtering them out - check the master toggle, severity floor, threshold, and quiet hours at Settings > Notifications.
  4. Operational findings also appear in the Daily Email Summary only if its Operational Alerts section is enabled.

Do alerts replace my SaaS observability tools?

No. Anomaly alerts are about your commerce data, not infrastructure. For platform-side incidents, you'll still see them via the live indicator and integration health UI in the dashboard.

Are alerts sent to all team members?

The in-app notifications panel is per-user. The daily email summary goes to whoever the workspace owner has configured (including additional CC recipients).

Related Guides


Last updated: July 31, 2026