This page lists Link Angel’s settings, its keyword rules, and the per-post controls. It is for site owners who want to adjust how automatic internal linking behaves. None of it is required — automatic mode runs on sensible defaults — but this is everything you can change.
Link Angel > Settings
| Setting | What it does | Default |
|---|---|---|
| Max links per page | The total number of links Link Angel adds to a page. Keyword-rule links and automatic title links share this one budget. | 3 |
| Open in a new tab | Whether links Link Angel adds open in a new tab. | Not stated in the plugin documentation |
| Rel attributes | The rel attributes applied to links Link Angel adds. |
Not stated in the plugin documentation |
| Rule priority order | The order in which rules are applied when more than one could match. Keyword rules take priority over automatic title links. | Keyword rules first |
| Post types | Which post types Link Angel processes. | Not stated in the plugin documentation |
| CSS class | A CSS class added to links Link Angel inserts, so you can style or identify them. | Not stated in the plugin documentation |
| Skip classes | Elements carrying one of these classes are left link-free. The built-in skip class is no-linkangel. |
no-linkangel |
| Leave REST API responses unlinked | Keeps Link Angel links out of REST API responses, so headless sites can choose whether to opt in to linked REST content. | On |
Link Angel > Keyword Rules
This screen manages your keyword-to-URL rules:
- Each rule is a keyword and a target. Targets can be full URLs or site paths such as
/freddy-krueger/. - Variants: add comma-separated synonyms to a rule (for example “Ghostface, Ghost Face”) and every variant links to the same target.
- Rules take priority over automatic title links, and both draw from the shared Max links per page budget.
- The screen also shows the title index coverage (“covers X of Y eligible posts”) and has a “Rebuild title index” button, which schedules a fresh background build of the title index (while a build is already running, it reports “busy”).
Default rules
On activation, Link Angel adds a small default rule set — only rules whose target page is published on your site, so no dead links are created. Two example sets ship side by side: horror names (Michael Myers, Jason Voorhees, Freddy Krueger, Chucky / Charles Lee Ray, Ghostface / Ghost Face, Pinhead, and Cenobites) and neutral site pages (Getting Started, Frequently Asked Questions / FAQ, Contact Us, Privacy Policy). Common human names are only linked as full names, so a bare “Michael” or “Jason” is never linked. Edit or delete any default rule on this screen.
Per-post controls
A Link Angel box on every post gives you control for that post alone:
- Disable auto-linking on this post.
- Stop other posts from auto-linking to this post.
- Add post-specific rules that apply only to this post.
Keeping sections of a page link-free
- Wrap content in
<!-- linkangel:off -->and<!-- linkangel:on -->. - Give an element a skip class (default
no-linkangel, configurable under Skip classes above). - Add
data-linkangel="off"to an element.
Some places are always skipped, with no setting involved: headings (h1 to h6), existing links, code and pre blocks, captions, buttons, form fields, scripts, styles, and all HTML attributes such as image alt text. Shortcode output is also protected: Link Angel runs before WordPress expands shortcodes, and shortcode tags and their contents are restored unchanged. HTML that is already rendered before Link Angel runs — such as dynamic blocks — is treated like normal post text, so use one of the opt-outs above if you need it kept link-free.
Automatic mode guards (fixed behaviour)
- Titles must have at least two words and six characters to be linked automatically.
- Titles made only of common words are ignored, and duplicate titles are never used.
- The front page and password-protected posts are excluded as targets.
- Only the first occurrence of each keyword is linked, a page never links to itself, and a page already linked is never linked twice.
- Matching is case-insensitive and whole-word, and understands typographic quotes and HTML entities.