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

# Keywords

## Overview

The Keywords page is where you define and manage every term Threadlytics monitors on Reddit. It is divided into three sections: **Keyword Monitor** (your primary tracked terms), **Global Context Keywords** (must-include filters), and **Global Negative Keywords** (must-exclude filters).

## Keyword Monitor

This is the main section. Each keyword you add here triggers Reddit searches and accumulates mentions over time.

### Keyword Table Columns

| Column        | Description                                                   |
| ------------- | ------------------------------------------------------------- |
| **Keyword**   | The term or phrase being tracked on Reddit                    |
| **Type**      | Classification: **Brand**, **Competitor**, or **Industry**    |
| **Tags**      | Optional metadata labels to help organize keywords            |
| **Status**    | Green dot = active (monitored); Grey dot = inactive (paused)  |
| **Mentions**  | Total unique Reddit posts and comments matched so far         |
| **Sentiment** | Percentage of mentions with positive sentiment (e.g., "+75%") |
| **Actions**   | Per-row dropdown for Edit, Refresh, Reset, and Delete         |

### Adding a Keyword

Click **Add Keyword** to open the creation form. Fields include:

* **Keyword** – the word or phrase to search for
* **Type** – Brand, Competitor, or Industry
* **Tags** – optional organizational labels
* **Related keywords** – alternative phrasings or synonyms
* **Context keywords** – additional terms that must also appear in a post for it to count (narrows results)
* **Negative keywords** – terms that disqualify a post (reduces noise)
* **Target subreddits** – restrict monitoring to specific communities

### Refresh & Sync

* **Refresh All** – triggers a full backend sync for all active keywords.
* **Individual Refresh** – refreshes only one keyword. A progress bar shows the current stage and estimated time remaining

### Bulk Actions

Select multiple keywords using the checkboxes (Shift+Click for range selection) to:

* **Activate** or **Deactivate** in bulk
* **Reset** – clears all gathered mentions for the selected keywords
* **Delete** – permanently removes the keywords and their data

### Usage & Limits

A usage indicator at the top shows how many keywords and mentions your plan allows (e.g., "5 / 10 keywords used"). Limits are enforced per plan tier.

### Role-Based Access

* **Admins** have full create, edit, refresh, and delete permissions
* **Members** see a read-only view — action buttons are visible but disabled, and a banner explains their access level

## Global Context Keywords

Context keyword collections act as reusable "must-include" filters. When a collection is applied to a keyword type, only mentions that contain at least one of the context terms will be kept.

| Field               | Description                                       |
| ------------------- | ------------------------------------------------- |
| **Collection Name** | A label for the group (e.g., "Purchase Intent")   |
| **Description**     | Optional notes on what the collection is for      |
| **Apply to Type**   | Brand, Competitor, Industry, or All keyword types |
| **Keywords**        | The list of terms that must appear in a mention   |

**Clean Up Existing Mentions** – re-evaluates all stored mentions against the current context rules and removes any that no longer qualify.

## Global Negative Keywords

Negative keyword collections act as reusable "must-exclude" filters. Any mention containing one of these terms is automatically discarded.

| Field               | Description                                                       |
| ------------------- | ----------------------------------------------------------------- |
| **Collection Name** | A label for the group (e.g., "Job Listings Noise")                |
| **Description**     | Optional notes                                                    |
| **Apply to Type**   | Brand, Competitor, Industry, or All                               |
| **Keywords**        | Terms that disqualify a mention (e.g., "jobs", "gaming", "cheap") |

**Clean Up** – permanently deletes stored mentions that match the current negative keyword lists, keeping your data clean after you update the rules.