--- title: "Alerts for flows, checklists and launchers" slug: "alerting" description: "Monitor Flow performance with Userflow's custom alert policies and AI-driven FlowAI Insights for proactive issue detection and quick intervention." tags: ["Userflow Alerts", "Alert Policies", "Performance Monitoring", "Real-time Alerts", "Flow Alerts"] updated: 2026-11-13T16:29:34Z published: 2026-11-13T16:29:34Z canonical: "help.userflow.com/alerting" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.userflow.com/llms.txt > Use this file to discover all available pages before exploring further. # Alerts for flows, checklists and launchers Alerts tell you when a flow, checklist or launcher stops performing the way you expect. Userflow has two kinds: **custom alert policies**, where you set the thresholds yourself, and [**Signals**](/userflow/docs/ai-insights), which spot big changes in a flow's performance with no setup. - **Custom alert policies:** Threshold-based alerts you configure for Flows, Checklists, and Launchers (for example, when views or completion rates fall below a defined limit). - **Signals:** Automatic AI-driven insights that detect meaningful performance changes in Flows and highlight exactly where users are dropping off or encountering issues, with no manual setup required. > [!NOTE] > Are alerts included in my Userflow plan? > > Alerting availability depends on your plan — check your [billing settings](https://app.userflow.com/app/_/settings/billing) to see what's included. ## Custom alert policies Custom alert policies let you define explicit thresholds for when Userflow should alert you about performance issues in Flows, Checklists, and Launchers. These alerts help identify potential issues with auto-start conditions, targeting rules, or flow performance, enabling quick intervention before user experience is impacted. - You configure alerts for metrics such as Unique views, Completion rate, Activation rate, and missing Tooltip target rate over a chosen timeframe. - Create and manage policies in **Settings > Alerting**, which can be assigned to multiple content items and trigger email and in-app alerts when conditions are met. ## Signals: automatic alerts for big changes in a flow Signals automatically monitors your Flows and surfaces high-impact performance changes as insight “cards” above the Flow analytics dashboard. - FlowAI analyzes views, completion volume, step-level drop-offs, and element errors over time (week-over-week, month-over-month, quarter-over-quarter) and only shows the most significant, high-impact movement and issues. - You can receive email notifications by clicking Subscribe on the Flow’s Analytics tab, and each insight links directly to the affected step or metric so you can act quickly. ### Custom alerts vs. Signals | **Aspect** | **Custom alert policies** | **Signals** | | --- | --- | --- | | **Setup** | Manually configured thresholds per Flow, Checklist, or Launcher in **Settings > Alerting**. | No setup required; automatically enabled for eligible Flows. | | **Coverage** | Views, completion rate, activation rate, and missing tooltip target rate. | View changes, completion volume changes, step views analysis, and element errors. | | **Scope** | Flows, Checklists, and Launchers. | Flows only. | | **Trigger logic** | Alert fires when your defined metric drops below the threshold within the specified timeframe. | Insight appears when the AI detects statistically significant, high-impact changes (e.g., sudden drops >50% or to zero). | | **Noise level** | You control sensitivity via thresholds; this may require tuning. | Prioritized to show a maximum of three negative and one positive insight per Flow, focusing on high-impact issues. | | **Email notifications** | Configured on each policy with specific recipients. | Enabled per Flow via **Subscribe** on the Analytics tab. | ### Set up the business region for Signals Configure your business region so Signals can account for natural fluctuations in activity, such as weekends and holidays. This will prevent false alerts for expected trends. 1. Select **Settings > Alerting** from the sidebar. 2. Select your business region from the dropdown. ![Business region dropdown in Settings > Alerting](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/image(598).png) Signals cards and settings are covered in full in [Signals](/userflow/docs/ai-insights). ## How do I create a custom alert policy? 1. Select **Settings > Alerting** from the sidebar. ![Alerting page in Settings](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/image(125).png) 2. Click the **New** button corresponding to the alert type you want to create – a Flow, Checklist, or Launcher policy. 3. Enter a policy name. ![Naming a new alert policy](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/image(126).png) 4. Use the toggle switch to activate one or more metrics to monitor, then enter the number or percentage threshold and duration for each. For example, *25 unique views over 4 days* or a *50% drop over 5 days*. - Unique views (All policy types) - Completion rate (Flows & Checklists) - Missing tooltip target rate (Flows) - Activation rate (Launchers) 5. By default, the **Notify by email** toggle switch will be activated with the checkbox selected for the user creating the alert. Add email addresses for (up to eight) additional recipients in the spaces provided. Regardless of whether email alerts are active for a policy, alerts will appear at the top of the flow. ![Alert policy metrics, thresholds and email recipients](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/image(127).png) 6. Use the toggle switch to activate monitoring for the desired environments. 7. To designate the new policy as a default for all future Flows, Checklists, or Launchers, select the checkbox to make it the default policy. 8. Click **Create alert policy**. 9. If Flows, Checklists, or Launchers already exist, you will be prompted to select which flows this policy should be assigned to. ![Choosing which flows an alert policy applies to](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/image(128).png) **Here you can:** - Select all - Select all with no policy - Deselect all - Select individual items 10. Click **Save assignments**. ### Change which content a policy covers, or edit or delete a policy After creating an alert policy, you can manage the Flows, Checklists, or Launchers it is assigned to, or edit or delete a policy. From the **Alerting** settings, click the options menu next to a policy and select the desired option. Complete the prompts that follow.![Options menu next to an alert policy](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/image(129).png) ### When does an alert trigger and resolve? Every 6 hours, we evaluate all content items against their respective alert policies. An alert is triggered if all of the following is true: - The content item is assigned to an alert policy. - The policy is monitoring the environment. - The content item is published in the environment. - Alerts are not muted for the content item. - Any monitored metric falls below the defined threshold. - The content item has been published for a duration equal to or longer than the chosen metric’s timeframe. Example: If a policy monitors “over 3 days”, it does not make sense to trigger an alert until the content item has been published for at least 3 days. Triggered alerts result in immediate email notifications: ![Alert email](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/alert-email.png) An alert remains active until the concerning metric meets or surpasses the threshold. Once resolved, another email notification is sent. The Userflow UI displays active alerts in 3 places: 1. The **Content** list highlights items with ongoing alerts via a red bell icon. 2. The **Builder** page displays a red bar at the top. 3. Similarly, the **Analytics** page showcases a red alert bar. ![Active alert](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/active-alert.png) Active alerts also show on the home dashboard. See [Analytics](/userflow/docs/analytics). ## How do I mute alerts for a flow? After addressing the underlying issue of an alert, you can choose to mute it for a specific period, like a day. Select **Mute alerts** from the three-dot menu on the content's **Analytics** page. Muted alerts are auto-resolved silently, meaning no email notifications are sent. Alert checks remain paused during the mute period and resume afterwards. A fresh alert only triggers after the mute period if the metric is still below the defined threshold. Number of distinct users who have seen a piece of content at least once. Percentage of users who complete a flow or checklist after viewing it - a key adoption metric. Percentage of users who saw a launcher and then activated it (clicked/hovered). A contextual UI element attached to in-app product elements for inline guidance. A persistent list of tasks or items that users can follow to ensure completion of techniques, often used for onboarding, setup, or feature adoption.