# 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
climat*                   # Wildcard match
```

### Field Search

```
author.displayName:"John Doe"   # Author display name
author.username:john_doe        # Author username
platform:x                      # Platform filter
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

| Action | Steps |
|  --- | --- |
| **Add date filter** | Calendar icon → Select range → Apply |
| **Add platform** | Platforms dropdown → Check boxes → Auto-applies |
| **Add risk signals** | Risk signals dropdown → Select Bot-like/Toxic |
| **Toggle filter on/off** | Click eye icon on filter pill |
| **Remove one filter** | Click × on filter pill |
| **Remove all filters** | Clear 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


### Save As (Use Segment as Template)

1. Load existing segment
2. Make modifications
3. Click down arrow next to Save icon
4. Select "Save As"
5. Enter new name
6. 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

| Indicator | Meaning |
|  --- | --- |
| 🟦 Indigo border | Matches saved segment |
| 🟦 Teal border | Unsaved changes |
| Filter pills | Active filters |
| Eye icon on pill | Toggle filter on/off |
| Grayed out pill | Filter is toggled off |
| ↓ Chevron | Query collapsed (2 lines) |
| ↑ Chevron | Query expanded (full) |


## Keyboard Shortcuts

| Key | Action |
|  --- | --- |
| **Enter** | Apply query |
| **↑/↓** | Navigate field suggestions |
| **Tab/Enter** | Select field suggestion |
| **Esc** | Close suggestion dropdown |
| **Shift+Enter** | New 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
```

### Wildcard Search

```
# Find climate variations
Query: climat*
Matches: climate, climatic, climatology
```

### Exclusion Pattern

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

## Troubleshooting Quick Fixes

| Problem | Solution |
|  --- | --- |
| No results | Remove filters one at a time; check toggled-off filters |
| Wrong results | Check operator CAPS (AND vs and) |
| Can't save | Ensure at least one filter active |
| Segment auto-dirty | Click Revert to reset |
| Suggestions not showing | Type field name slowly |


## Best Practices

✅ **DO:**

* Use descriptive segment names
* Start broad, narrow with filters
* Quote exact phrases
* Use wildcards for variations (climat*)
* Use "Save As" to create templates
* Toggle filters to validate results
* 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

| Icon | Name | When Enabled | Action |
|  --- | --- | --- | --- |
| 💾 | Save | Changes present | Save/Update segment |
| ▼ | Save dropdown | Segment active | Access "Save As" option |
| ↺ | Revert | Segment modified | Restore saved state |
| ✕ | Clear | Segment active | Reset all filters |
| ⏵ | Apply | Query changed | Run search |
| 👁️ | Toggle | Always | Enable/disable filter |
| 🗑️ | 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.)


## Available Fields

### Post Content

| Field | Type | Example |
|  --- | --- | --- |
| `text` | string | `text:"climate change"` |
| `title` | string | `title:"breaking news"` |
| `body` | string | `body:"full article text"` |
| `lang` | string | `lang:en` |


### Author Fields

| Field | Type | Example |
|  --- | --- | --- |
| `author.displayName` | string | `author.displayName:"John Doe"` |
| `author.username` | string | `author.username:john_doe` |
| `author.followers` | integer | `author.followers:>10000` |
| `author.following` | integer | `author.following:<500` |
| `author.isBotLike` | boolean | `author.isBotLike:true` |
| `author.platform` | string | `author.platform:x` |
| `author.postCount` | integer | `author.postCount:>100` |
| `author.profileBio` | string | `author.profileBio:"journalist"` |
| `author.cohorts` | dict | `author.cohorts:Label>=0.5` |


### Aggregate/ID Fields

| Field | Type | Example |
|  --- | --- | --- |
| `platform` | string | `platform:x` |
| `createdAt` | timestamp | `createdAt:>2024-01-01` |
| `authorId` | string | `authorId:12345` |
| `postId` | string | `postId:abc123` |
| `narrativeId` | string | `narrativeId:xyz789` |


### Narrative Fields

| Field | Type | Example |
|  --- | --- | --- |
| `narrative.title` | string | `narrative.title:"Election"` |
| `narrative.postCount` | long | `narrative.postCount:>100` |
| `narrative.compassHeadline` | string | `narrative.compassHeadline:"Crisis"` |
| `narrative.compassOneSentence` | string | `narrative.compassOneSentence:"summary"` |
| `narrative.compassSummary` | string | `narrative.compassSummary:"detailed"` |
| `narrative.executiveBriefing` | string | `narrative.executiveBriefing:"brief"` |
| `narrative.totalEngagement` | long | `narrative.totalEngagement:>1000` |
| `narrative.totalEngagementWithoutNews` | long | `narrative.totalEngagementWithoutNews:>500` |
| `narrative.weightedRiskScore` | double | `narrative.weightedRiskScore:>5.0` |


## Quick Diagnostics

### "Nothing happens when I search"

→ 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; check for toggled-off filters

## 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: March 2026*