What it is

CSV import allows you to add keywords to Keyword.com in bulk. You can:

Import large keyword sets at once
Migrate keywords from another rank tracker
Preserve historical ranking data

The guided import wizard takes you through four stages: Upload, Map, Review, and Import. This is the recommended method for large setups and tool migrations.

Why it matters

Manually adding keywords is slow and error‑prone at scale.

CSV import provides:

Faster onboarding.
Consistent keyword configuration.
Early detection of invalid rows and duplicate keywords.
No loss of historical ranking context when switching tools.
Background processing, so you can continue working while a large import finishes.

How it works

Step 1: Open the Import tool

There are two ways that you can access the Import tool

From the main menu:

From the main navigation, click Import Data
Choose Import keywords from CSV

From the Add Keyword screen:

Step 2: Download the CSV template

Download the Keyword.com CSV template. This template defines the required structure for importing keywords and optional historical data.

If you are exporting from another tool, you can use the wizard to map the columns in your file to the corresponding Keyword.com fields.

Step 3: Prepare your CSV file

You can include:

Import Field	Description	Example
Project Name	Domain name or custom name	`miro.com`
Group Name (legacy)	Domain name or custom group name	`Miro - Group Name`
Domain	The url you are tracking	`miro.com/pricing`
Keyword	keyword you are tracking	`collaboration boards`
Region	Google TLD region	`google.co.uk`
Language	Tracked language	`en`
Tags	Keyword tag	`uk`
Type	Desktop or Mobile	`mobile`
Start Rank	Rank when you started tracking this keyword	`5`
Best Rank	Best rank tracked for keyword	`3`
Current Rank	The latest rank result	`6`
Search Location	Tracked location	`London, UK`
GMB	Google My Business name	`Miro Inc`
Included In SOV	Indicate if keyword is to be included in Share of Voice calculation - `Yes / No`	`Yes`
Url Tracking Method	Select `Broad` or `Exact`	`Broad`
Ignore Subdomains	Ignore sub-domain when tracking url - `0` / `1`	`0`

Location format requirement

When importing locations via CSV, location values must match a format recognised by Google’s geo targeting system.

We recommend using Google’s official Geo Targets reference to ensure locations are valid and consistently interpreted.

Using unsupported or ambiguous location formats can result in inconsistent or unexpected rankings.

Historical data format

You can import historical rankings alongside your keywords.

Add one column per date.
Put the applicable date in each historical column header.
The wizard accepts the date format used in your file.
You can include as many date columns as needed within the CSV and file-size limits.

⚠️ Note: CSV cells are limited to 32,767 characters

⚠️ File-size limit: The maximum supported import file size is 50 MB.

Step 4: Upload your file

In the Upload step:

Select the CSV file you want to import.
Upload the file.
Continue to the Map step.

Large imports run in the background after you start the import, so you can continue working elsewhere in Keyword.com while processing finishes.

Step 5: Map your data

Keyword.com automatically matches the columns in your file to the corresponding import fields.

In the Map step:

Review each automatic column mapping.
Adjust any mapping that does not match the contents of the column.
Make sure your keyword configuration and historical ranking columns are mapped correctly.
Continue to the Review step.

Step 6: Review and fix problems

The Review step checks the import before any rows are added. Invalid rows and duplicate keywords are flagged so that you can correct problems before starting the import.

Review the problems identified by the wizard.
Correct the affected rows in your source file.
Upload the corrected file again if needed.
Continue when the file is ready to import.

Step 6: Import

Click Import to complete the process.

Your keywords will be added to the selected project and historical rankings will be available immediately.

Location & device considerations

If your CSV does not explicitly specify a location:

Keyword.com will apply the default location based on the selected Google region (capital city)

If your CSV does not specify a device:

Desktop tracking is applied by default

For consistent results, especially for local keywords, explicitly set both location and device in your CSV.

What to expect

Imported keywords count toward your keyword allowance
Historical data is visible immediately after import
Imported keywords behave the same as manually added keywords

Best practices

Use CSV import for migrations, not inline bulk add
Review the automatic column mappings before continuing.
Resolve invalid rows and duplicate keywords during the Review step.
Always validate location and device columns
Keep a backup of your original CSV

Import your keywords from CSV