dotjuice-plugin-docs/docs/dotjuice-elementor-tools/widgets/keyword-linker.md

Keyword Linker

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

Found in the Elementor panel under Dotjuice → Keyword Linker.

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.