---
title: "Build a Target Keywords workspace"
description: "Adopt real Search Console demand, import external research, assign intended pages, and catch when Google ranks a different URL."
canonical: "https://crawlraven.com/docs/target-keywords"
markdown: "https://crawlraven.com/docs/target-keywords.md"
product: "CrawlRaven v2"
last_verified: "2026-08-19"
---

# Build a Target Keywords workspace

> Adopt real Search Console demand, import external research, assign intended pages, and catch when Google ranks a different URL.

This guide documents current CrawlRaven v2 behavior. UI labels are written exactly where relevant. Bounded Search Console rows are evidence, not guaranteed exhaustive totals.

## Understand Workspace and Discovered queries

`Workspace` holds the keywords you decided to target or ignore. `Discovered queries` shows Search Console queries that are not in the workspace yet. An empty workspace opens on discovery first so you can begin with real demand instead of a blank table.

Choose a 28-day, 90-day, or 16-month discovery window. Use Include and Exclude term filters to narrow the vocabulary, then select rows and choose Adopt selected or Ignore selected. One action can include up to 200 selected queries.

## Add keywords by discovery or CSV

### Adopt Search Console queries

1. **Open Discovered queries** — Choose the evidence window and optional Include or Exclude terms.
2. **Review the top page and metrics** — Use clicks, impressions, and position to decide whether a query belongs in the plan.
3. **Select the rows** — Use individual checkboxes or the table checkbox, then Adopt selected.

### Import keyword research

In Workspace, select `+ Import keywords`. Drop a CSV file, browse for one, or paste CSV text. CrawlRaven recognizes Ahrefs, Semrush, and generic headers and previews mapped fields and row errors before import.

> **Use the sample file when in doubt:** The basic shape is `Keyword, Target URL, Volume, Difficulty`. Target URLs should include `https://` so the intended page can be saved correctly.

## Assign pages, groups, and priority

Select Edit on a target row to add or change the intended page, intent group, and priority. The target URL must start with `http://` or `https://`. Saving an edit marks the row as manually maintained so later imports do not overwrite your edits.

- **Target page:** The URL you intend to rank for the keyword.
- **Intent group:** A reusable planning label such as pricing, comparison, or how-to.
- **Priority:** High, Medium, or Low — your editorial decision, separate from Search Console metrics.
- **Source:** Adopted, Imported, or Manual records where the target originated. Editing marks it as manually maintained without rewriting that original source.
- **Volume / KD:** Optional external research values supplied by an import; a dash means no value was provided.

![CrawlRaven Target Keywords workspace and discovered queries table](/images/changelog/changelog-targets-2026-08-02.png)

*The workspace combines planning fields with live Search Console evidence and a separate discovery queue.*

## Use live evidence and mismatch labels

- **Observed page** is the page Google currently returns for the target in the selected evidence window.
- **ranks elsewhere** means the observed page differs from the intended Target page. It is evidence only; CrawlRaven does not overwrite your assignment.
- **not returned** means the bounded Search Console report did not return the keyword. It does not prove the keyword has zero impressions.
- **partial evidence** means the evidence batch reached its retrieval bound.
- **Intent group conflict** means keywords in one group point at multiple planned pages. Review whether that split is intentional.

Search the workspace or filter by Volume and Keyword difficulty. Sort by keyword, Search Console metrics, Volume, or Difficulty. Use Targeted and Ignored to move terms out of the active plan without deleting their history. Full workspace access includes CSV export of the active status and filters.