> For the complete documentation index, see [llms.txt](https://help.seoutils.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/create-a-tracker.md).

# Create a Tracker

A tracker follows a list of keywords in one market. The wizard walks you through it in five steps, and the first one opens by itself the first time you visit **Rankings** on a property.

{% hint style="info" %}
You need a connected Search Console property. See [Google Search Console](https://help.seoutils.app/guide/google-search-console.md) to connect one.
{% endhint %}

## Open the wizard

Open a property and choose **Rankings** in the page menu of the top bar (the name of the current page, right after the domain). To add another tracker later, open the tracker selector next to the page title and choose **New tracker**.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-2b3c1f69c609d416e37754120f475e72b7c8fa86%2Fgsc-rankings-property-menu.png?alt=media" alt="The page menu in the top bar with the Rankings item after Performance"><figcaption><p>Rankings (1) sits right after Performance in the page menu</p></figcaption></figure>

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-d8983b5e72b7866251f600418acfe13da5590cf9%2Fgsc-rankings-tracker-selector.png?alt=media" alt="The tracker selector listing two trackers and a New tracker item"><figcaption><p>Add more trackers from the selector</p></figcaption></figure>

## The five steps

{% stepper %}
{% step %}

#### Start

Choose how to begin:

* **Blank tracker**: pick a market, then add keywords yourself.
* **Duplicate a tracker**: shown when the property already has a tracker. Pick the tracker, then click **Next** to open the [Duplicate dialog](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/manage-trackers.md#duplicate-a-tracker), where you name the new tracker and can choose another country, device or search type. The new tracker gets the keywords, rules and thresholds of the one you picked, and the remaining steps are skipped.
* **Start from an Organic Rank Tracker report**: copy the keywords and the market of an [Organic Rank Tracker](https://help.seoutils.app/guide/organic-rank-tracker.md) report for this site, and link it. Click **Copy keywords** next to the report. The option is disabled, with its reason, when no report matches the site.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-866e8b37d9939c58cf3b56eea16371af33b6c22e%2Fgsc-rankings-wizard-start.png?alt=media" alt="Wizard step 1 with Blank tracker, Duplicate a tracker and Start from an Organic Rank Tracker report"><figcaption><p>Step 1: start blank, from a tracker or from a report</p></figcaption></figure>
{% endstep %}

{% step %}

#### Market

A tracker covers one market, so its numbers are never mixed across countries or devices.

* **Country**: sorted by clicks in the last 90 days, with each country's share of your impressions. Choose **Worldwide** for all countries.
* **Device**: **All devices**, **Desktop** or **Mobile + tablet**, each with its share of impressions.
* **Search type**: **Web**, **Image**, **Video** or **News**.

The box under the options tells you how much of your traffic the market covers and how many of your top 100 keywords would have mostly low data days there. The top country and **All devices** are selected for you.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-e54fa437367835d8701c7ea4c06b034e930eeb73%2Fgsc-rankings-wizard-market.png?alt=media" alt="Wizard step 2 with country, device and search type"><figcaption><p>Step 2: choose the market</p></figcaption></figure>
{% endstep %}

{% step %}

#### Keywords

The **Keywords** step has three tabs. A bar at the bottom always shows what your tracker holds, for example "100 keywords · 2 rules".

**Paste / Import**

* Paste one keyword per line and click **Add**. Duplicates are skipped.
* Or click **Choose CSV file**. Use the columns `keyword`, `target_url` and `tags` (up to 8 MB).

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-2d9eddd5f4cfbffcd028201bb56c55b157946dac%2Fgsc-rankings-wizard-keywords-paste.png?alt=media" alt="The Paste / Import tab with a keyword box, a tags field and a CSV button"><figcaption><p>Paste keywords or import a CSV file</p></figcaption></figure>

**Tags for these keywords** (optional, 1) sits under the paste box. Type a tag and press Enter or a comma, and every keyword of that paste gets the tag, including keywords the tracker already has. Tags are only added, never removed. You can use up to 20 tags per paste, and the field keeps them for your next paste until you remove them.

After you click **Add** (2), a message says how many keywords were added and how many existing ones were tagged, for example "Added 2 · 1 existing keyword tagged". The same field is in **Add keywords** on an existing tracker.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-6eedbd3e1dd42a98b01104c27ba81af4ede5db49%2Fgsc-rankings-wizard-keywords-tags.png?alt=media" alt="The Paste / Import tab with three keywords and the tag Competitors"><figcaption><p>Tag the pasted keywords</p></figcaption></figure>

**Suggestions**

Four lists built from your last 90 days of Search Console data. Tick queries, or click **Add all** to add the whole list.

| List                  | What it shows                                                                                    |
| --------------------- | ------------------------------------------------------------------------------------------------ |
| **Top by clicks**     | The 100 queries with the most clicks in this market over the last 28 days.                       |
| **Striking distance** | Queries averaging between position 7.5 and 20.5 with many impressions: close to the top results. |
| **New this month**    | Queries whose first impression came in the last 30 days, with at least 20 impressions since.     |
| **Volatile**          | Queries whose daily position moved a lot over the last 28 days.                                  |

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-de498f8888207cd68a31c817e93e81db7e456911%2Fgsc-rankings-wizard-keywords-suggestions.png?alt=media" alt="The Suggestions tab with its four lists"><figcaption><p>Add suggestions one by one or all at once</p></figcaption></figure>

**Rules**

A rule is **one row** in your tracker that follows every query it matches, including queries that appear later, as a group with one combined position. Build it with a **Type**:

* **Query rule**: the query **contains**, **starts with**, **ends with** or **matches regex** a value.
* **Page rule**: the page URL **equals**, **starts with**, **contains** or **matches regex** a value. Use full URLs, for example `https://harborpine.example/blog/`.

Then choose how to add it:

* **As one rule** adds a single row.
* **As keywords** adds one row for each matching query: a fixed list that does not grow.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-e1a99e47d8e6b07193a4258c1c8dd2a396293005%2Fgsc-rankings-wizard-keywords-rules.png?alt=media" alt="The rule builder with the As one rule and As keywords options"><figcaption><p>A rule can be one group row or a list of keywords</p></figcaption></figure>

{% hint style="info" %}
A rule picks up new matching queries by itself. You can track any query of a rule on its own later. See [Rules in Read your rankings](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/read-your-rankings.md#rules).
{% endhint %}
{% endstep %}

{% step %}

#### Targets

Optional. A **target page** is the page you want a keyword to rank with. SEO Utils flags the days Google shows another page instead.

Click **Suggest targets** to pre-fill each keyword with the page that got the most impressions for it, then **Accept all** or edit any row. The target must belong to the property. Click **Skip** to set targets later.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-10f235b0e57cc6ad33ca440274320770f454305d%2Fgsc-rankings-wizard-targets.png?alt=media" alt="Wizard step 4 with suggested target pages"><figcaption><p>Step 4: accept or edit suggested target pages</p></figcaption></figure>
{% endstep %}

{% step %}

#### Review and create

* **Name**: defaults to the market, for example "US · All devices · Web".
* **Thin threshold**: days with fewer impressions than this are faded and left out of averages. Default 5.
* **Move threshold**: how many positions a keyword must move to count as a move. Default 5. See [Alerts](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/alerts.md).
* **Desktop notifications**: show a notification when a refresh finds new alerts.
* **Weekly AI summary**: off by default. Turn it on for a short AI write-up of the tracker every Monday. See [AI](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/ai.md#weekly-summary).
* **Rank tracker report**: link an [Organic Rank Tracker](https://help.seoutils.app/guide/organic-rank-tracker.md) report to compare it with Search Console. SEO Utils suggests the first compatible report for the market. See [Compare with Organic Rank Tracker](https://help.seoutils.app/guide/google-search-console/gsc-rank-tracker/compare-with-organic-rank-tracker.md#in-the-new-tracker-wizard).

Click **Create tracker**.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-2384bf5950c7eaf05f09e3a4105537170788b3f1%2Fgsc-rankings-wizard-review.png?alt=media" alt="Wizard step 5 with name, thresholds, notifications, the Weekly AI summary switch and the Rank tracker report link"><figcaption><p>Step 5: review and create. The Weekly AI summary switch (5) names the model it will use</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## After you click Create

SEO Utils downloads 16 months of history for every keyword and rule. A progress panel shows the batches as they are saved, and the numbers on the page fill in while it runs.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-32f766247c0a205aebad6d2496660db80a0202ed%2Fgsc-rankings-run-progress.png?alt=media" alt="The refresh progress panel showing batches being saved"><figcaption><p>The progress bar (1): history downloads in batches, and positions appear as each batch lands</p></figcaption></figure>

The tracker then refreshes itself every 6 hours while the property's **Auto-sync Enabled** setting is on. You can refresh at any time with **Refresh now**.

{% hint style="info" %}
Keywords you add later get their own 16 months of history. New trackers never create alerts for the past: alerts start from the moment a keyword's history is complete.
{% endhint %}
