Create custom alerts

Alerts tell you when something crosses a threshold you care about. Rules are checked once a day, after each daily sync, so an alert reflects what changed since the previous day’s data.

Building a rule

1. On the Alerts page, click New alert.
2. Pick a trigger — critical rank drop, top 10 entry, low-star review, rating drop, milestone approaching, or download anomaly.
3. Set the threshold and severity.
4. Optionally, pick a Slack channel to post this rule’s alerts to (paid plans, with Slack connected in Settings → Integrations). You can also change it later from the Slack pill on the rule’s card.

Rating drop watches the star figure shown on your WordPress.org listing page, not the raw score behind it, so it tells you when the number your users see actually changes. It needs two days of history before it can say anything.

How alerts reach you

Rules are checked at the end of each daily sync, against the data that sync just refreshed. Anything that fires appears on the Alerts page and is emailed as one digest to the workspace’s alert contact: the owner, unless someone else is chosen under Settings → General → Send alert emails to.

Rules with a Slack channel are also posted there: one message per channel for each check, most severe first. Only alerts fired after you pick the channel are posted, so turning Slack on doesn’t replay a rule’s history. If a post fails (say the channel was deleted, or the WPInsight app isn’t in a private channel), it’s retried at the next check for up to two days. The History tab shows when each alert was emailed and posted.

Example

“Alert me critical when my plugin drops more than 5 rank positions for a tracked keyword in 24 hours.”

Related

• Notifications — the in-app feed alerts also surface in.
• Slack integration — connect Slack, and set up per-plugin reports.