# Keyword Linker

Turn chosen words into links automatically, across every post using a template.

Found in the Elementor panel under **Dotjuice → Keyword Linker**.

![The Keyword Linker repeater with several keyword rows](../assets/img/keyword-linker-controls.png)
*Screenshot: the widget's **Keyword Links** repeater expanded, showing two or three keyword rows with their URL, Bold and Link all occurrences settings.*

## How it works

This widget renders nothing visible. It works in the background: it hooks into WordPress's content output, scans for the keywords you've defined, and converts matching occurrences into links. Add it once to a template that renders post content — a Single Post or Single Page Theme Builder template — and it applies to every post or page using that template.

That "invisible widget on a template" model is the part people trip over. You are not adding it to one article; you are adding it to the template all your articles share.

**Matching rules:**

- Only text inside paragraph (`<p>`) and heading tags is scanned. Text inside list items, tables, or custom block markup is left alone.
- Matching is **whole-word**, so `cat` will not match `category`.
- Matching is **case-insensitive**, and the matched text keeps its original capitalisation in the resulting link — you don't need to define both "Elementor" and "elementor".
- Text that is already inside a link is never re-linked, so you won't get nested anchors.

## Content settings — Keyword Links

A repeater. Add one row per keyword you want linked.

| Setting | Default | What it does |
|---|---|---|
| **Keyword** | — | The word or phrase to look for. Whole-word, case-insensitive. |
| **URL** | — | Where the link points. Supports Elementor's usual open-in-new-tab and nofollow options. |
| **Bold link text** | Off | Renders the generated link in bold. |
| **Link all occurrences** | Off | On: every match on the page is linked. Off: only the first few, capped by Max links. |
| **Max links** | 3 | Only shown when **Link all occurrences** is off. How many times this keyword may be linked on a single page (1–50). |

:::tip Why you usually want the cap
Linking every occurrence of a common word reads as spam to both visitors and search engines. The default of three is deliberate — it catches the keyword early in the article where it matters, and leaves the rest as plain text.
:::

## Setting it up

1. Open the Theme Builder template that renders your post content — typically **Single Post**. Do not add this to an individual page.
2. Drop the Keyword Linker widget anywhere on that template. Position is irrelevant; it renders nothing.
3. Add a row per keyword, each with its destination URL.
4. Decide per keyword whether to link every occurrence or cap it.
5. Save, then visit a post containing one of your keywords and confirm the link appears.

## Good to know

- **It must sit on a template that actually renders post content.** On a page with no post content being output there is nothing to scan, so nothing happens. This is the most common reason it appears not to work.
- **Links are only added inside `<p>` and heading tags.** If your target text lives in a list, table, or a custom block's markup, it won't be matched — move the text into a paragraph if you need it linked.
- **Keywords are matched independently.** If two keywords overlap in the same sentence, both can be linked; there's no ordering guarantee between them, so avoid defining a keyword that is a substring of another phrase you also link.
- Because it works on rendered output rather than stored content, removing the widget removes every generated link cleanly — your posts are never modified in the database.