> ## Documentation Index
> Fetch the complete documentation index at: https://docs.statusstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crowdsourced Incidents

> How StatusStack detects service issues through community reports before official status pages update

## Overview

<Info>
  **Pro or Enterprise plan required.** Crowdsourced incident detection is available on [Pro and Enterprise plans](/account/subscription-plans). Free plan users can view official status page incidents only.
</Info>

Crowdsourced Incidents are service disruptions detected through community feedback before the official status page acknowledges the problem. When multiple users report issues with a service, StatusStack aggregates these reports, assigns a confidence score, and can alert your team — often before the provider's own status page reflects the outage.

***

## How It Works

```mermaid theme={null}
graph LR
    A[User Reports] -->|Multiple reports| B[Report Aggregation]
    B -->|Threshold met| C[Incident Created]
    C -->|Confidence scored| D[Team Notified]
    D -->|Provider confirms| E[Official Incident Linked]
```

### Detection Flow

1. **Community Reports** — Users across StatusStack report issues they're experiencing with a service
2. **Aggregation** — StatusStack groups reports by service and timeframe to identify patterns
3. **Threshold Detection** — When reports cross a confidence threshold, a crowdsourced incident is created
4. **Confidence Scoring** — Each incident receives a confidence score based on report volume, consistency, and timing
5. **Notification** — Your team is alerted about the potential issue
6. **Resolution** — The incident is resolved when the service recovers or the official status page confirms and resolves the issue

***

## Incident Details

Each crowdsourced incident includes:

| Field                   | Description                                                        |
| ----------------------- | ------------------------------------------------------------------ |
| **Source**              | The service experiencing reported issues                           |
| **Title**               | Summary of the reported problem                                    |
| **Severity**            | Estimated impact level                                             |
| **Confidence Score**    | How confident StatusStack is that this is a real incident (0–100%) |
| **Total Reports**       | Number of user reports contributing to this incident               |
| **Detection Method**    | How the incident was initially detected                            |
| **First Report**        | Timestamp of the earliest user report                              |
| **Detection Lead Time** | How far ahead of the official status page the issue was detected   |

### Confidence Levels

| Level      | Score Range | Meaning                                                    |
| ---------- | ----------- | ---------------------------------------------------------- |
| **High**   | 80–100%     | Strong evidence of a real incident across multiple reports |
| **Medium** | 50–79%      | Likely a real issue but with fewer confirming reports      |
| **Low**    | Below 50%   | Early signal that may or may not indicate a real problem   |

***

## Early Warning Advantage

Crowdsourced incidents give your team a head start on incident response. The **detection lead time** shows how far ahead of the official status page StatusStack detected the issue.

**Common scenarios where crowdsourced detection is faster:**

* Provider status pages that update slowly or infrequently
* Regional outages that aren't yet reflected on global status pages
* Partial degradations that affect some users before being officially acknowledged
* New or emerging issues during the early minutes of an incident

***

## Notifications for Crowdsourced Incidents

Crowdsourced incidents integrate with StatusStack's existing notification system. When a crowdsourced incident is detected for a service in one of your Stacks, your notification rules apply as usual.

This means you can receive early warnings through:

* Slack, Discord, or Microsoft Teams
* Email notifications
* SMS alerts
* Custom webhook integrations

***

## Best Practices

<AccordionGroup>
  <Accordion title="Use Confidence Scores to Prioritize">
    Don't treat all crowdsourced incidents equally. High-confidence incidents (80%+) warrant immediate investigation, while low-confidence ones may be worth monitoring before taking action.
  </Accordion>

  <Accordion title="Pair with Official Monitoring">
    Crowdsourced incidents complement — not replace — official status page monitoring. Use them as an early warning layer on top of your existing monitoring setup.
  </Accordion>

  <Accordion title="Review Detection Lead Times">
    Track how much advance warning crowdsourced detection gives you for services you depend on. This helps you understand the value and adjust your incident response accordingly.
  </Accordion>
</AccordionGroup>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Sources" icon="globe" href="/concepts/sources">
    Understanding monitored services
  </Card>

  <Card title="Notifications" icon="bell" href="/concepts/notifications">
    Multi-channel notification system
  </Card>

  <Card title="Status Monitoring" icon="chart-line" href="/guides/status-monitoring">
    Real-time status monitoring guide
  </Card>

  <Card title="Notification Setup" icon="sliders" href="/guides/notification-setup">
    Configure alert rules
  </Card>
</CardGroup>
