# Detailed Stats Widget

## Overview

The **Detailed Stats Widget** is a pair of side-by-side summary panels displayed at the top of the Post Analysis page in Constellation. It provides instant, filter-aware metrics across four key dimensions — posts, engagements, platforms, and authors — giving analysts a high-level picture of their current dataset before diving into individual posts.

All values update dynamically as filters are applied or removed in the Segment Bar.

> **Note:** Numbers in the summary panels are displayed as exact, comma-separated integers (for example `36,123` rather than `36.1K`) so analysts can read and copy the underlying counts during investigations.


### What You Can Do

* **Monitor** post volume, total engagements, and platform count at a glance
* **Track** author counts and top cohort breakdowns for the current filtered view
* **Drill down** into detailed platform and author breakdowns via the inline details dialog
* **Validate** that active filters are returning the expected scope of data before beginning post-level analysis


## Navigating to the Detailed Stats Widget

1. Open your project in **Constellation 3.0**
2. From the left navigation menu, select **Posts**
3. The **Detailed Stats Widget** is displayed at the top of the page, above the Activity Timeline


## Widget Layout

The Detailed Stats Widget consists of two panels arranged side by side:

1. **Posts / Engagements / Platforms Panel** — Aggregated post volume, engagement, and platform metrics
2. **Authors Panel** — Author count and cohort breakdown metrics


Each panel is clickable and opens a **details dialog** with a deeper breakdown of the metrics shown.

## Posts / Engagements / Platforms Panel

This panel displays three primary metrics for the currently filtered dataset:

| Metric | Description |
|  --- | --- |
| **Total Posts** | The total number of posts matching the current filters |
| **Total Engagements** | The aggregated engagement count (likes, shares, comments, quotes, reactions, and views) across all filtered posts |
| **Total Platforms** | The number of distinct platforms that have at least one post in the filtered dataset |


**Pro Tip:** A low **Total Platforms** count relative to your **Total Posts** may indicate platform concentration — a useful early signal when investigating coordinated activity.

### Posts / Engagements / Platforms Details Dialog

Clicking the **Posts / Engagements / Platforms** panel opens a details dialog titled "Posts, engagements, and platforms breakdown." This dialog provides a deeper breakdown including:

* Post type distributions
* Per-platform engagement totals
* Engagement hierarchy metrics


> **Note:** The details dialog reflects the same filtered dataset as the summary panel. Apply or change filters before opening the dialog to ensure the breakdown matches your intended scope.


## Authors Panel

The **Authors Panel** displays author-level aggregates for the currently filtered dataset:

| Metric | Description |
|  --- | --- |
| **Total Unique Authors** | The number of distinct authors who have at least one post in the filtered dataset |
| **Top Cohorts** | The most represented author cohort classifications in the filtered dataset |
| **Bot-Like Author Count** | The number of authors who exhibit bot-like posting behaviors |


### Authors Details Dialog

Clicking the **Authors** panel opens a details dialog with a full author breakdown, including per-cohort author counts and additional author-level metrics for the filtered dataset.

## Tips & Best Practices

### For Efficient Analysis

* **Use the widget as a filter sanity check** — After applying a segment or boolean query, review the Detailed Stats Widget before scrolling down to the Data Grid. If the post count or engagement numbers are unexpectedly low, your filters may be overly restrictive.
* **Click through for platform breakdowns** — The Posts / Engagements / Platforms details dialog shows per-platform data, making it easy to identify which platforms are contributing most to the current view.
* **Watch the Authors panel for anomalies** — A very high post count relative to a low unique author count can indicate coordinated or bot-driven activity worth investigating further.


### For Cohort Analysis

* **Use the Top Cohorts display** — The Authors panel surfaces the most active cohorts in your filtered dataset without requiring a separate query. Use this to validate that your filters are capturing the intended cohort population.
* **Combine with cohort filters** — After identifying a high-volume cohort in the Authors panel, apply a cohort filter in the Segment Bar to isolate that cohort's posts in the Data Grid.


## Troubleshooting

### "The widget numbers seem lower than expected"

* The Detailed Stats Widget reflects only the **currently filtered dataset**. Check the Segment Bar for active filter pills that may be restricting the data.
* If the **Segment Overlay Search** is active on the Post Analysis page, it applies an additional boolean query on top of your segment. Clear the overlay query and check whether the numbers change.


## Summary

The Detailed Stats Widget gives analysts an immediate, high-level view of their filtered dataset directly from the Post Analysis page:

* **Posts / Engagements / Platforms Panel** for volume, engagement totals, and platform count
* **Authors Panel** for unique author counts and top cohort representation
* **Details Dialogs** for per-platform and per-author metric breakdowns
* **Dynamic updates** that reflect all active Segment Bar filters and overlay search queries in real time