Keyword mapping is the SEO practice of assigning one primary keyword (and 3–5 secondary keywords) to each page on a website, documented in a spreadsheet that links URL to target keyword, search intent, and on-page element guidance. It prevents keyword cannibalization — where multiple pages compete for the same query — and ensures every page on the site has a clear, non-overlapping ranking focus.
Without keyword mapping, sites with more than 20 pages routinely develop keyword cannibalization — multiple pages fighting for the same query — and content gaps where important queries have no page at all. A keyword map is the operating document that prevents both problems simultaneously.
What is keyword mapping?
Keyword mapping is an organisational layer that sits between keyword research (finding keywords) and content production (creating pages). It answers a specific question for every page on your site: "What is this page trying to rank for, and is there any other page trying to rank for the same thing?"
A keyword map is typically a spreadsheet with the following columns:
- URL — the exact page address
- Primary keyword — the single most important query this page targets
- Secondary keywords — 3–5 related terms, synonyms, and question variants
- Search intent — informational, commercial, transactional, or navigational
- Monthly search volume — for the primary keyword
- Keyword difficulty — KD score for prioritisation
- Title tag — the page's current or planned title tag
- H1 — the main heading including the primary keyword
- Status — existing page, draft, planned, or needs optimisation
Google allocates ranking signals per URL. If one page tries to rank for "CRM software," "best CRM," and "CRM for small business" simultaneously, the signals are diluted. Assigning one primary keyword per page forces clarity — each page has one job, and the title tag, H1, and opening paragraph all reinforce that single focus.
Why keyword mapping matters for SEO performance
Keyword mapping solves three distinct problems that emerge as sites grow:
- Prevents cannibalization. Two pages targeting "email marketing tools" split link equity and ranking signals between them, leaving neither in position 1. A map catches this conflict before new content is published.
- Guides on-page optimisation systematically. Instead of guessing what each page should be optimised for, the map gives every writer and editor a clear brief: primary keyword in title, H1, and first paragraph; secondary keywords in H2s and body.
- Surfaces content gaps. When you map existing pages, the blank spaces in your keyword list reveal topics you haven't covered. These become your new content priorities.
- Improves internal linking strategy. When every page's target keyword is documented, you can identify natural internal link opportunities — pages that mention a topic but don't link to the page that owns that keyword.
- Creates accountability at scale. For sites publishing 10–30 articles per month, the map ensures the editorial team never accidentally creates two articles competing for the same query.
How to build a keyword map — step by step
A keyword map for an existing site takes a different approach than one for a new site. Here's the process for each:
For an existing site (audit + map)
- Crawl your site. Use Screaming Frog or Ahrefs' Site Audit to export all URLs, title tags, and H1s.
- Pull current rankings. In Google Search Console, export your top 200 queries and the page each query sends impressions to. This shows what each page is already associated with.
- Assign primary keywords. For each URL, select the highest-volume, most relevant keyword from the GSC data as the primary. If the page ranks for nothing, select the intended keyword from your research.
- Flag conflicts. Sort by primary keyword. Any duplicate primary keywords are cannibalization conflicts — you need to consolidate or differentiate those pages.
- Add secondary keywords and intent. Complete the remaining columns for each URL.
For a new site (plan + map)
- Complete keyword research first. You need a prioritised keyword list before mapping.
- Group by intent. Cluster keywords by intent type. Informational queries → blog posts; commercial queries → comparison/category pages; transactional queries → product/service pages.
- Design the site structure from the map. Each cluster of related keywords becomes a content hub. The highest-volume keyword in each cluster becomes the pillar page.
- Assign keywords to planned URLs. Even before the pages exist, assign them a URL and a primary keyword. This prevents duplication before a single article is written.
Keyword mapping approaches by site type
| Site type | Mapping approach | Pages per map | Review frequency |
|---|---|---|---|
| SaaS / B2B blog | 1 keyword per blog post, cluster by topic | 20–500+ | Monthly |
| E-commerce | Category + product pages, faceted URL handling | Hundreds to thousands | Quarterly + crawl alerts |
| Local business | Service + location page matrix | 10–200 | Quarterly |
| Publisher / media | Topic clusters with URL hierarchy | Thousands+ | Automated + quarterly audit |
Real keyword mapping examples
Example 1 — SaaS product (project management)
/features/ → Primary: "project management software"
/blog/agile-guide/ → Primary: "what is agile project management"
/blog/kanban-boards/ → Primary: "kanban board examples"
/compare/asana/ → Primary: "asana alternative"
# Conflict detected and fixed
/blog/pm-software/ → Primary: "project management software" (CONFLICT)
Action: merge /blog/pm-software/ into /features/ with 301 redirect
Example 2 — Local accountancy firm
/services/tax-returns/ → "tax returns accountant"
/services/tax-returns/london/ → "tax returns accountant London"
/services/tax-returns/bristol/ → "tax returns accountant Bristol"
/blog/self-assessment-guide/ → "how to complete self assessment tax return"
Keyword mapping vs keyword research — how they connect
These are sequential steps in the same workflow — research feeds mapping, mapping guides content production.
Keyword research (comes first)
- Discovers what queries exist with search demand
- Evaluates volume, difficulty, and intent
- Produces a prioritised list of target keywords
- Happens before any content decisions are made
- Refreshed when new topics or products emerge
Keyword mapping (comes second)
- Assigns research outputs to specific pages
- Prevents duplicate targeting across the site
- Produces the on-page brief for each URL
- Becomes the operating doc for the content team
- Updated whenever new pages are published
7 best practices for keyword mapping
- One primary keyword per page, strictly enforced. If two pages need the same primary keyword, consolidate them. Exceptions only for genuinely different intents on the same topic (e.g. "buy running shoes" vs "how to choose running shoes").
- Match intent before matching keyword. The search intent of the page must align with the searcher's intent for the primary keyword. A product page mapped to an informational query will struggle to rank because the format doesn't match what Google serves.
- Start with existing pages before planning new ones. Mapping what you already have reveals both conflicts to fix and gaps to fill — both are high-ROI actions before any new publishing.
- Include the primary keyword in three mandatory elements. Title tag (near the front), H1, and first 100 words of body copy. Secondary keywords belong in H2s and throughout the body.
- Keep the map living. A keyword map that doesn't get updated when new pages go live becomes inaccurate and loses its cannibalization-prevention value within weeks. Assign a map maintainer.
- Link from secondary to primary. When a new page mentions a topic that has a primary keyword owner elsewhere in the site, add an internal link. The map tells you exactly which URL to link to.
- Review for drift quarterly. Pages get edited, new competitors emerge, and intent shifts. A quarterly audit ensures your mapped primary keyword still reflects what's actually ranking on page 1 for that query.
Many teams build a forward-looking keyword map for new content but ignore the dozen existing pages already cannibalising each other. Google can't decide which of your three "email marketing tools" pages to rank — and it picks none of them, or ranks the wrong one. Audit existing cannibalization before mapping new content.
Common keyword mapping mistakes to avoid
- Mapping by volume only — a high-volume keyword assigned to the wrong page type (intent mismatch) won't rank regardless of the content quality.
- Treating keyword mapping as a one-time project — the map must be updated every time a new page is published or a redirect is implemented.
- Ignoring secondary keywords — the primary keyword drives the H1 and title; secondaries drive the depth and breadth of content. Mapping only the primary leaves the page thinner than it needs to be.
- Mapping the same keyword to parent and child URLs — a category page and a subcategory page with the same primary keyword will compete. Give each a distinct term from the same cluster.
- Not sharing the map with writers — the map is only useful if content creators reference it before writing. Embed it in your editorial brief template.
Frequently asked questions
Keyword mapping is the practice of assigning a primary keyword and a set of secondary keywords to each page on your website. It is documented in a spreadsheet (URL, primary keyword, secondary keywords, intent, search volume, KD) and used to guide on-page optimisation and prevent two pages from competing for the same keyword.
Start with a spreadsheet listing all your URLs. For each URL, identify the primary keyword it should rank for (based on content and intent match), add 3–5 secondary keywords, note search volume and KD, and flag any pages that overlap. Update the map whenever you add new pages or target new keywords.
Keyword research finds and prioritises keywords. Keyword mapping assigns those keywords to specific pages. Research is the discovery phase; mapping is the organisational phase. You need research before you can map, and you need a map before you can systematically optimise.
One primary keyword (the main ranking target) and 3–5 secondary keywords (related terms, synonyms, question variants) per page. The primary keyword drives your title tag and H1; secondaries inform subheadings and body content. Trying to rank one page for 10+ unrelated keywords produces a diluted, unfocused page.
By giving each keyword a single designated "owner" page in your map, you ensure no two pages target the same primary keyword. When you publish new content, you check the map first — if the keyword is already claimed, you either add internal links from the new page to the existing owner page or consolidate the content.
Related glossary terms
Find the keywords your customers actually search, scored by difficulty and intent.
Sources
- [01]Ahrefs — Keyword Mapping: The Simple Guide for SEOs
- [02]Semrush — Keyword Mapping: What It Is and How to Do It
- [03]Moz — Keyword Cannibalization: How to Find and Fix It
- [04]Google Search Central — SEO Starter Guide: Title Tags and H1s
- [05]Search Engine Journal — Keyword Mapping for SEO: A How-To Guide