# Narrative List

## Overview

The **Narrative List** page in Constellation displays AI-discovered narratives present within a project's data set, enabling analysts to quickly triage, filter, and prioritize narrative threats. Narratives are automatically identified by the **Narrative Discovery Agent**, which continuously scans project data and surfaces emerging storylines for review. In the best case scenario, a single AI narrative may represent a complete, reportable finding that can be shared with stakeholders directly.

**What You Can Do**

* **Browse** all narratives detected in your project in a familiar inbox-style layout with infinite scroll
* **Sort** narratives by risk rating, bot percentage, Compass Risk, total posts, total engagement, or total authors
* **Filter** narratives using the Segment Bar with narrative-specific field syntax
* **Search** narratives by title and summary using the quick search bar
* **Prioritize** high-volume narratives using the default post-count-descending sort order, or switch to Risk Rating to surface the highest-risk narratives instead
* **Triage** narratives efficiently by combining search, filters, and sorting


## Navigating to Narrative List

1. Log in to **Constellation**.
2. Select the desired **Project** from the project selector in the top navigation bar.
3. Click **Analyze** in the top navigation menu.
4. Select **Narratives** from the left sidebar.


## Page Layout

The Narrative List page is organized into three primary areas:

1. **Segment Bar** — Located at the top of the page; used to apply advanced filters using boolean field syntax.
2. **Narrative List Panel** — The left-hand panel displaying the list of discovered narratives with summary metadata.
3. **Narrative Detail Panel** — The right-hand panel displaying detailed information for the selected narrative.


## Narrative Discovery Agent

The **Narrative Discovery Agent** automatically identifies and groups narratives from the posts in your project data set. Narratives are presented in an inbox-style format, allowing analysts to scan and triage them efficiently without manual grouping or tagging.

> **Note:** A narrative will appear in the list if **any** posts within that narrative match the active search or segment criteria — not only narratives where all posts match.


## Narrative List Panel

The **Narrative List Panel** displays each discovered narrative as a card with key metadata. Narratives are ordered according to the active sort setting. The list uses **infinite scroll** — as you scroll down, additional narratives are loaded automatically.

### Narrative Card Metadata

| **Field** | Description |
|  --- | --- |
| **Narrative Title** | The AI-generated title summarizing the narrative's central claim or theme |
| **Post Count** | Total number of posts associated with this narrative |
| **Engagement** | Total engagement (reactions, shares, replies) across all narrative posts |
| **Author Count** | Number of unique authors contributing to the narrative |
| **Narrative ID** | Unique system identifier for the narrative |
| **Risk Indicator** | Color-coded risk badge reflecting the narrative's overall risk rating |


## Sorting the Narrative List

The **Narrative List** can be sorted using the sort control located at the top-right of the **Narrative List Panel**. Click the sort icon to open the **Sort by** menu. All sort options support both ascending and descending order.

### Available Sort Options

| **Sort Option** | Description |
|  --- | --- |
| **Risk Rating** | Orders narratives by their overall risk assessment |
| **Compass Risk** | Orders narratives by the Compass Risk rating — Low, Medium, or High |
| **Total Engagement** | Orders narratives by the aggregate engagement across all posts |
| **Total Posts** | Orders narratives by the total number of associated posts (default: descending) |
| **Total Authors** | Orders narratives by the number of unique authors participating in the narrative |
| **Bot-Like Post Density** | Orders narratives by the percentage of authors classified as bot-like |
| **Anomalous Density** | Orders narratives by the percentage of posts classified as anomalous |


**Pro Tip:** The default sort is **Total Posts descending**, which surfaces the highest-volume narratives at the top of the list. Switch to **Risk Rating** to instead prioritize the narratives most likely to pose the greatest risk.

## Filtering the Narrative List

### Quick Search Bar

The **Search** bar at the top of the **Narrative List Panel** provides fast, keyword-based filtering. The search operates against the **narrative title** and **narrative summary** fields. It does not search the full text of individual posts.

### Segment Bar Filtering

The **Segment Bar** at the top of the page supports advanced boolean filtering and includes narrative-specific field syntax.

To view all available narrative fields:

1. Click into the **Segment Bar** boolean field input.
2. Type `narrative`.
3. The **typeahead assistant** will display a list of all narrative-specific fields available for filtering.


**Pro Tip:** Narrative-specific fields allow you to filter directly on narrative-level attributes (such as risk rating thresholds or bot score ranges), enabling more precise triage than post-level filters alone.

### Combining Filters

For projects containing a large number of narratives, it is recommended to use a combination of the **Segment Bar** filters and **sort controls** together to identify emergent and evolving narratives efficiently.

> **Note:** Segment filters and the quick search bar can be used simultaneously. The narrative list will reflect all active constraints at once.


## Tips & Best Practices

### For Efficient Triage

* **Start with the default sort** — The post-count-descending default ensures the highest-volume narratives are visible immediately upon navigating to the page. Switch to **Risk Rating** to prioritize by risk instead.
* **Use the quick search bar for known topics** — If you are monitoring a specific subject, enter relevant keywords to narrow the list to narratives whose titles or summaries mention that topic.


### For Large Data Sets

* **Layer filters and sorting** — Projects may contain thousands of narratives. Applying a **Segment Bar** filter first to narrow the scope, then sorting within the filtered results, is the most effective approach for large data sets.
* **Explore narrative-specific fields** — Type `narrative` in the **Segment Bar** to discover fields that are not available for standard post-level queries, giving you finer control over which narratives are surfaced.


### For Bot and Risk Analysis

* **Sort by Bot-Like Post Density** — When investigating coordinated inauthentic behavior, sorting by **Bot Percentage** descending highlights narratives with the highest concentration of automated activity.
* **Sort by Compass Risk** — Use the **Compass Risk** sort to prioritize narratives flagged by Blackbird AI's analytical framework for geopolitical or influence operation risk.


## Troubleshooting

### "No narratives are appearing in the list"

* Verify that a **Project** has been selected and that it contains ingested posts.
* Check whether an active **Segment Bar** filter is too restrictive; clear or modify the filter and re-apply.
* Confirm that the **Narrative Discovery Agent** has completed its initial analysis of the project data set.


### "My search returns unexpected results"

* The quick search bar only queries **narrative title** and **narrative summary** fields. If you are searching for post-level content, use the **Segment Bar** or navigate to the **Posts** page instead.
* Ensure there are no typographical errors in the search query.


### "A narrative I expect to see is not appearing"

* Recall that a narrative appears if **any** of its posts match the active criteria. If the segment filter excludes all posts associated with a narrative, that narrative will not be displayed.
* Broaden the active **Segment Bar** filter or clear it entirely to confirm the narrative exists in the project.


## Summary

The **Narrative List** page provides an efficient, AI-powered interface for discovering and triaging narratives within a Constellation project. Narratives are automatically surfaced by the **Narrative Discovery Agent** and displayed in an inbox-style layout with infinite scroll for rapid review.

Key components and capabilities covered on this page:

* **Narrative Discovery Agent** — Automatically identifies and groups narratives from project data
* **Narrative List Panel** — Displays narrative cards with metadata including posts, engagement, authors, and risk indicators; supports infinite scroll
* **Sort Controls** — Order narratives by risk rating, bot percentage, Compass Risk, total posts, total engagement, or total authors; ascending and descending
* **Quick Search Bar** — Filters narratives by title and summary for fast topic-based lookup
* **Segment Bar** — Applies advanced boolean filters including narrative-specific field syntax accessible via the typeahead assistant