Skip to main content

​
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.
Imports create new keywords only. They do not update or delete existing keywords.

​
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.
The CSV export covers the main keywords on the Keywords page. It does not include Global Context Keyword collections or Global Negative Keyword collections.

​
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:
Only term is required. The other columns are optional.

​
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:
For targetSubreddits, enter the subreddit name without r/, such as cybersecurity or soc2.
If a value contains a comma, wrap the full CSV cell in double quotes. For example: "governance, risk, and compliance".

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