Skip to content
Last updated

Segment Bar Quick Reference

Search Syntax Cheat Sheet

Boolean Operators

climate AND policy # Both terms required
climate OR environment # Either term
climate AND NOT hoax # Exclude term
"climate change" # Exact phrase
(A OR B) AND C # Grouped logic
author.displayName:"John Doe" # Author display name
author.username:john_doe # Author username (read-only)
platform:x # Platform filter (aggregate)
author.followers:>1000 # Follower count
text:"climate change" # Main text content
title:"breaking news" # Post title
lang:en # Language filter
author.postCount:>100 # Author post count
author.isBotLike:true # Bot-like flag
narrative.title:"Election" # Narrative title

Combined Example

("climate change" OR "global warming")
AND platform:x
AND author.followers:>500
AND NOT conspiracy

Filter Actions

ActionSteps
Add date filterCalendar icon → Select range → Apply
Add platformPlatforms dropdown → Check boxes → Auto-applies
Add risk signalsRisk signals dropdown → Select Bot-like/Toxic/High-risk
Remove one filterClick × on filter pill
Remove all filtersClear button (X icon) in top bar

Segment Workflow

Save New Segment

  1. Build query + filters
  2. Click Save icon (disk)
  3. Name segment
  4. Click Save

Load Segment

  1. Click segment dropdown
  2. Select segment name
  3. Filters auto-apply

Update Segment

  1. Modify active segment
  2. Border turns teal (unsaved)
  3. Click Save icon
  4. Segment updates

Revert Changes

  1. Click Revert icon (↺)
  2. Returns to saved state
  3. Border returns to indigo

Visual Indicators

IndicatorMeaning
🟦 Indigo borderMatches saved segment
🟦 Teal borderUnsaved changes
Colored pillsActive filters
↓ ChevronQuery collapsed (2 lines)
↑ ChevronQuery expanded (full)

Keyboard Shortcuts

KeyAction
EnterApply query
↑/↓Navigate field suggestions
Tab/EnterSelect field suggestion
EscClose suggestion dropdown
Shift+EnterNew line in query

Common Patterns

Temporal Analysis

# Last week's bot-like content
Date: Last 7 days
Risk Signal: Bot-like

Platform Comparison

# Same topic across platforms
Query: "vaccine safety"
Platforms: X, Facebook, Reddit

High-Activity Analysis

# Prolific authors on climate topic
Query: climate OR environment
author.postCount:>100
Platform: X

Exclusion Pattern

# Climate policy, no conspiracies
Query: climate AND policy NOT (hoax OR conspiracy OR fraud)
Date: Last 30 days

Troubleshooting Quick Fixes

ProblemSolution
No resultsRemove filters one at a time
Wrong resultsCheck operator CAPS (AND vs and)
Can't saveEnsure at least one filter active
Segment auto-dirtyClick Revert to reset
Suggestions not showingType field name slowly

Best Practices

✅ DO:

  • Use descriptive segment names
  • Start broad, narrow with filters
  • Quote exact phrases
  • Save working combinations
  • Use UPPERCASE operators

❌ DON'T:

  • Forget closing quotes
  • Mix AND/and (must be UPPERCASE)
  • Over-filter (start simple)
  • Leave segments unsaved
  • Ignore dirty state indicator

Button Reference

IconNameWhen EnabledAction
💾SaveChanges presentSave/Update segment
↺RevertSegment modifiedRestore saved state
✕ClearSegment activeReset all filters
⏵ApplyQuery changedRun search
🗑️Delete(hover segment)Remove segment

Field Auto-Suggest

How to use:

  1. Type partial field name
  2. Dropdown appears
  3. Arrow keys to select
  4. Tab/Enter to insert
  5. Type your value after :

What you see:

  • Field name in monospace font
  • Description of field
  • Data type (text, number, date)
  • Entity type (post, author, etc.)

Filter Pills Color Legend

ColorFilter Type
🟣 PurplePlatforms
🔵 BlueDate Range
🟢 GreenCohorts
🟡 YellowSearch Query
🔴 RedRisk Signals
🟠 OrangeEntities

(Colors may vary by theme)

Publicly Accessible Fields

Post Content (Filterable)

FieldTypeExample
textstringtext:"climate change"
titlestringtitle:"breaking news"
bodystringbody:"full article text"
langstringlang:en

Author Fields

FieldTypeAccessExample
author.displayNamestringfilterauthor.displayName:"John Doe"
author.usernamestringread-onlyauthor.username:john_doe
author.followersintegerfilterauthor.followers:>10000
author.followingintegerfilterauthor.following:<500
author.isBotLikebooleanfilterauthor.isBotLike:true
author.platformstringfilterauthor.platform:x
author.postCountintegerfilterauthor.postCount:>100
author.profileBiostringfilterauthor.profileBio:"journalist"
author.cohortsdictfilterauthor.cohorts:Label>=0.5

Aggregate/ID Fields

FieldTypeExample
platformstringplatform:x
createdAttimestampcreatedAt:>2024-01-01
authorIdstringauthorId:12345
postIdstringpostId:abc123
narrativeIdstringnarrativeId:xyz789

Narrative Fields (Filterable)

FieldTypeExample
narrative.titlestringnarrative.title:"Election"
narrative.postCountlongnarrative.postCount:>100
narrative.compassHeadlinestringnarrative.compassHeadline:"Crisis"
narrative.compassOneSentencestringnarrative.compassOneSentence:"summary"
narrative.compassSummarystringnarrative.compassSummary:"detailed"
narrative.executiveBriefingstringnarrative.executiveBriefing:"brief"
narrative.totalEngagementlongnarrative.totalEngagement:>1000
narrative.totalEngagementWithoutNewslongnarrative.totalEngagementWithoutNews:>500
narrative.weightedRiskScoredoublenarrative.weightedRiskScore:>5.0

Access Levels:

  • filter - Fully filterable in queries
  • aggregate - Can be used for grouping/filtering
  • read-only - Limited query use

Quick Diagnostics

→ Check that Apply button is clicked/Enter pressed

"Segment won't save"

→ Must have active filters or query text

"Lost my work"

→ Check segment dropdown, may be auto-saved

"Too many results"

→ Add more specific filters or use AND operators

"Too few results"

→ Remove some filters or use OR operators

Need More Help?

  • Full Guide: See "Segment Bar User Guide" for detailed explanations
  • Admin: Contact for permission issues or quotas
  • Support: Report bugs or request features via feedback

Last Updated: February 2026