> ## 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.

# How to import and export keywords

> Export your Keyword Monitor settings to a CSV file or add multiple keywords at once with a CSV import.

# Import and export keywords

Use **Export CSV** to download your current keyword setup, or **Import CSV** to add multiple keywords at once. Importing is useful when you are setting up a new account, adding a list of competitors, or moving keyword settings between workspaces.

<Note>
  Imports create new keywords only. They do not update or delete existing keywords.
</Note>

## Who can use it

* All users with access to the Keywords page can export keywords.
* Only **Admin** users can import keywords.

## Export keywords

1. Open **Keywords** from the sidebar.
2. Click **Export CSV** at the top of the page.
3. Threadlytics downloads a file named `keywords-YYYY-MM-DD.csv`.

The exported CSV includes each keyword and its saved monitoring settings:

* Keyword term and type
* Tags
* Related keywords
* Context keywords
* Negative keywords
* Target subreddits
* Active or inactive status

Exporting is a good way to create a correctly formatted import template. You can edit the exported file in Excel, Google Sheets, or another spreadsheet tool, then import it again.

<Warning>
  The CSV export covers the main keywords on the Keywords page. It does not include Global Context Keyword collections or Global Negative Keyword collections.
</Warning>

## Import keywords

1. Open **Keywords**.
2. Click **Import CSV** in the upper-right corner.
3. Choose a `.csv` file from your computer.
4. Review the **Import Results** window.

The results show:

* **Rows processed**. The number of rows read from the file
* **Created**. The number of new keywords added
* **Skipped**. Rows that could not be added
* **Row-level reasons**. Details such as a missing term, duplicate keyword, or plan limit

After the import, click **Refresh** to begin collecting the latest Reddit results for your newly added keywords.

## CSV format

Your CSV must include a header row. Use these column names exactly:

```csv theme={null}
term,type,tags,contextKeywords,negativeKeywords,relatedKeywords,targetSubreddits,isActive
```

Only `term` is required. The other columns are optional.

| Column             | Required | What to enter                                                                                      |
| ------------------ | -------- | -------------------------------------------------------------------------------------------------- |
| `term`             | Yes      | The word, phrase, brand, or topic you want to monitor.                                             |
| `type`             | No       | `brand`, `competitor`, or `industry`. If blank or not recognized, the keyword is added as `brand`. |
| `tags`             | No       | Labels for organizing keywords.                                                                    |
| `contextKeywords`  | No       | Words that must appear with the main keyword for a mention to be relevant.                         |
| `negativeKeywords` | No       | Words that exclude a post from results.                                                            |
| `relatedKeywords`  | No       | Alternative names, spellings, or related terms to monitor alongside the main keyword.              |
| `targetSubreddits` | No       | Specific subreddits to monitor. Leave blank to monitor across Reddit.                              |
| `isActive`         | No       | `true` or `false`. Leave blank to add the keyword as active.                                       |

### Add multiple values in one field

For any list field (such as tags, context keywords, or target subreddits) separate values with a semicolon (`;`).

**For example:**

```csv theme={null}
term,type,tags,contextKeywords,negativeKeywords,relatedKeywords,targetSubreddits,isActive
Acme,brand,priority;enterprise,security;compliance,jobs;hiring,Acme Inc;Acme Cloud,soc2;cybersecurity,true
Competitor One,competitor,competitive,,jobs,CompetitorOne,saas;startups,true
GRC,industry,category,compliance;security,job;career,governance risk compliance,ciso;grc,false
```

For `targetSubreddits`, enter the subreddit name without `r/`, such as `cybersecurity` or `soc2`.

<Tip>
  If a value contains a comma, wrap the full CSV cell in double quotes. For example: `"governance, risk, and compliance"`.
</Tip>

## What happens during an import

Threadlytics checks each row independently. A problem with one row will not stop other valid rows from importing.

### Duplicate keywords

Threadlytics skips a keyword if the same term already exists in the selected workspace. Duplicate checks ignore capitalization, so `Acme`, `ACME`, and `acme` are treated as the same keyword.

### Missing keyword terms

Rows without a value in the `term` column are skipped.

### Keyword limits

Your subscription's keyword limit still applies during an import. If importing additional rows would exceed your limit, Threadlytics imports the rows that fit and skips the rest. The Import Results window will show that the limit was reached.

### Active and inactive keywords

Keywords are active by default. Use `false` in the `isActive` column when you want to save a keyword without monitoring it right away. You can activate it later from Keyword Monitor.

## Troubleshooting

### My file will not import

Make sure that:

* The file is saved as a `.csv` file.
* The first row contains the column headers.
* The header names use the exact spelling shown above.
* Each row has a value in the `term` column.
* List values are separated with semicolons, not additional CSV columns.

### Some keywords were skipped

Open the Import Results window to see the exact row number and reason. Common reasons are:

* The keyword already exists.
* The `term` field is blank.
* Your keyword limit has been reached.
* The row contains invalid data.

### I need to change existing keywords

Exporting and re-importing does not overwrite existing keywords. To change a keyword's type, filters, tags, or status, use the **Edit** action beside that keyword in Keyword Monitor.