Guides & documentation.

Installation & licence

1. Download the plugin zip from
   My Account
   .
2. In WordPress, go to Plugins → Add New → Upload Plugin, choose the zip and click Install Now, then Activate.
3. Open the new Snippet Sense menu in your admin sidebar, go to License, paste your licence key and activate it.

An active licence enables the AI features and automatic plugin updates. Your licence works on unlimited sites.

Connecting your AI provider

Snippet Sense uses your own API key, so you pay the provider directly at cost. Go to Snippet Sense → Settings, choose a provider, paste your key and pick a model.

• OpenAI — GPT-5.6 Luna (recommended), GPT-5.6 Terra (higher quality), GPT-5.6 Sol (premium), GPT-5.4 Mini and GPT-4.1 Mini (legacy). Get a key at platform.openai.com.
• Google Gemini — Gemini 3.7 Flash (recommended), Gemini 3.8 Flash (newest), Gemini 3.1 Pro (premium, preview), Gemini 3.5 Flash-Lite (budget) and Gemini 3.1 Flash-Lite (cheapest). Get a key at aistudio.google.com.
• OpenRouter — Claude Sonnet 5.5 (recommended), Claude Haiku 4.5 (budget) and Claude Opus 5.5 (premium), plus GPT-5.6 Luna, GPT-5.6 Terra, Gemini 3.7 Flash and Gemini 3.5 Flash-Lite — all with one key from openrouter.ai.

Key settings

• Custom instructions — default guidance added to every request, e.g. tone of voice, brand terms or “always mention free UK delivery”. You can override it per bulk batch.
• Automatic language — on by default; output is written in the language of your content.
• Auto-generate on publish — writes meta for new posts shortly after they're first published, if they don't already have a description.
• Minimum content length — posts shorter than this are skipped. Set it to 0 to process every page.
• Editor post types — choose which post types show the Snippet Sense boxes in the editor.
• TLDR, FAQ & schema — site-wide on/off switches, styling and placement options.

Brand Rules

The Brand Rules tab makes every generation sound like you. Rules are added to every prompt — post meta, taxonomy meta, TLDRs and FAQs — whether content is generated in the editor, in bulk, on publish or by an AI agent. Alt text uses the spelling, brand-term and banned-phrase rules only.

• Brand voice — describe your tone, e.g. “warm, expert, no hype”.
• English variant — British or American spelling.
• Banned words and phrases — if generated meta contains one, it's automatically regenerated once with feedback.
• Brand terms — product and brand names with their exact capitalisation.
• Per post type instructions — extra guidance for products, pages, posts or any custom type.
• Title suffix — optionally add something like “| Your Brand” to every SEO title Snippet Sense saves, including bulk runs, auto-generate and AI agents. It's never added twice, titles using SEO plugin variables (such as %%sitename%%) are skipped, and the AI is given a shorter title limit to leave room for it.

Meta titles & descriptions

Snippet Sense writes a meta title (under 60 characters), a description (under 160) and a 1–3 word focus keyword, then saves them into your active SEO plugin. Focus keywords are saved for Yoast SEO, Rank Math and SEOPress.

In the editor

Open any post, page or product and click Generate Meta Data in the Snippet Sense box. Not happy? Generate again, or edit the text directly.

In bulk

• Missing Meta — lists content without a meta description (optionally including items that only use your SEO plugin's default template). Select items and click Start.
• Rewrite Meta — shows the current and suggested meta side by side. Nothing is saved until you approve each one.
• Taxonomy Meta — generates meta for categories, tags, product categories/tags and custom taxonomies. Existing term meta is overwritten, so review before running.

Snippet Sense adapts its writing to the post type: persuasive copy for products, purpose-led copy for pages and editorial copy for posts.

Image alt text

The image itself is sent to a vision-capable model, so descriptions reflect what's actually in the picture.

• Bulk — the Alt Text tab lists images without alt text. Tick include images with alt text to improve existing ones.
• Single image — use the Snippet Sense box on the attachment edit screen.
• Extras — optionally generate the image title, caption and description too.
• Formats — JPG, PNG, WebP, AVIF and SVG (converted to PNG for the AI automatically).

TLDR summaries

A 2–3 sentence “key takeaways” box. Generate one per post from the editor or many at once from the TLDR bulk tab, or write your own.

• Placement — automatic (above your content) or manual with [snippet_sense_tldr]. Add id="123" to show another post's TLDR.
• Styling — title, background, border and text colours, plus an icon or emoji.
• Control — hide it on individual posts, or switch TLDRs off site-wide without losing your data.

FAQ generator

Creates 3–10 questions (5 by default) that your content answers, displayed as an accordion. You can add, edit or remove questions by hand.

• Schema — FAQPage JSON-LD is added to the page automatically, even with manual placement.
• Placement — automatic (below your content) or manual with [snippet_sense_faq].
• Styling — title, background, accent and text colours, and icon.

Schema

The AI chooses the best single type for each page — Article, Product, HowTo, Recipe, Review or LocalBusiness — using your site name, URL, author, dates and featured image. It's output as JSON-LD in the page head. Edit or disable schema per post, generate it in bulk, or turn it off site-wide.

AI internal links

In the editor, Find Internal Link Opportunities suggests 3–5 exact phrases in your content, each with a target post and the reason for the link. Click Insert Link to add one. The Internal Links bulk tab inserts links automatically across many posts.

Links are never placed inside headings, existing links, buttons, navigation, labels or captions. Targets are chosen from your 50 most recent published posts, pages and products.

AI featured images

The Image Gen bulk tab creates a featured image for each selected post or product and sets it as the thumbnail. Choose square, portrait or landscape, add style instructions, and optionally upload a reference image for a consistent look. Product prompts automatically include price and categories. Images are created with GPT Image 2.5 (OpenAI or OpenRouter) or Gemini 3.1 Flash Image (Google).

Site Health Wizard & bulk tools

The Site Health Wizard scans your chosen post types and media library and counts what's missing: meta, archive meta, alt text, TLDRs, FAQs, schema and link scans. Pick the categories to fix and it works through them one after another, with a cost estimate first.

Prefer to work task by task? The Bulk Generator has nine tabs: Missing Meta, Rewrite Meta, Taxonomy Meta, Schema, TLDR, FAQ, Alt Text, Internal Links and Image Gen. Each supports post-type filters, per-batch instructions, a live cost estimate, progress bar and processing log. Lists show up to 500 items at a time.

SEO score

Click Analyze SEO in the editor for a 0–100 score, a grade and a checklist. It checks meta title and description length, word count, H2 headings, internal links, featured and in-content images, and whether a TLDR, FAQ and schema are present. The score is rule-based and uses no API credits.

Search Console

The Search Console tab uses your Google Search Console data to find pages that are losing clicks and to measure the effect of your meta changes. Search Console features require an active licence.

Connecting

• Google Site Kit — if Site Kit is already connected to Search Console, Snippet Sense can reuse that connection with no setup.
• Service account — create a Google Cloud service account, download its JSON key and paste it in. Then add the service account's email address as a user on your Search Console property. Only the fields needed are stored, and the key is never shown again.
• Source — Snippet Sense uses the service account if one is saved, otherwise Site Kit. You can force either.

Your properties are listed and matched to your domain automatically (domain properties are preferred). Use Test connection to check everything works — errors explain the fix; for example, a 403 means the service account hasn't been added as a user in Search Console.

What it does

• Snapshots — 28-day page performance is saved weekly, keeping 18 months of history. Use Sync now to update immediately.
• CTR opportunities — pages ranking in the top 20 but getting fewer clicks than is typical for their position, ranked by estimated missed clicks.
• Rewrite with AI — generates a new title and description using the page's top search queries, current CTR and current meta. Review and edit the suggestion before applying it.
• Meta change impact — compares CTR, clicks per day and position for the 28 days before a change with up to 28 days after. At least 7 days of data after the change are needed.
• Change history — every title or description change made through Snippet Sense records when it happened and keeps the last 5 previous versions.

AI Visibility

The AI Visibility tab helps AI tools understand your site and shows which AI crawlers and assistants are visiting.

llms.txt

Turn on llms.txt to publish a generated /llms.txt in the llmstxt.org markdown format (it's off by default). It's built from your SEO meta descriptions, with excerpts as a fallback, and ordered by Search Console clicks when connected. Noindexed, password-protected and excluded pages are skipped. It's cached for 12 hours and refreshed whenever a post is saved.

• Settings — site summary, which post types to include, items per section and excluded post IDs.
• Physical files — if a real llms.txt file exists in your site's root folder, it overrides the generated one. The tab warns you if that happens.

AI crawler log

On by default. Snippet Sense logs visits from 18 AI crawlers and assistants — including OpenAI, Anthropic, Perplexity, Google, Meta, Amazon, Apple, DuckDuckGo, Mistral, Cohere, ByteDance and Common Crawl — grouped as model training, AI search indexing or a live fetch for a user. Daily totals per crawler and page are kept for 180 days, and no visitor data is stored. The crawler report shows totals by crawler and purpose, plus the most-fetched pages over the last 30 days.

AI agents (MCP)

Snippet Sense registers its SEO tools with the WordPress Abilities API. AI assistants connected to your site through the WordPress MCP Adapter — such as Claude, Cursor or other MCP-compatible tools — can then audit, read, update and generate SEO data using Snippet Sense's rules, your brand rules and your SEO plugin's real fields.

Setup

1. Make sure your site runs WordPress 6.9 or later (which includes the Abilities API).
2. Install and activate the WordPress MCP Adapter plugin, then connect your AI assistant to your site using a WordPress user account.
3. In Snippet Sense → Settings, check that AI Agents (MCP) is switched on (it's on by default).

Available abilities

• get-seo-guidelines — your SEO plugin, length limits (including the limit before your title suffix), language rule, brand rules, custom instructions and enabled post types.
• get-seo-meta — current title, description and focus keyword for up to 50 posts or terms, with length warnings.
• audit-seo — missing descriptions, length issues, duplicate titles and images missing alt text.
• update-seo-meta and update-term-seo-meta — write meta for up to 50 posts, or for a category/tag archive. They warn about banned phrases and miscapitalised brand terms, and dry runs show the title exactly as it will be saved.
• update-image-alt — set alt text (and optionally title, caption, description) for up to 50 images.
• set-schema — save a JSON-LD schema object for a post.
• generate-seo-meta, generate-image-alt and generate-schema — use your configured AI provider to create suggestions (these use your API credits).
• get-ai-crawler-activity — AI crawler visits by bot, purpose and page.
• get-search-performance, find-ctr-opportunities and measure-meta-impact — Search Console insights (available when Search Console is connected).

Compatibility

• SEO plugins — Yoast SEO, Rank Math, All in One SEO (v4+), SEOPress, The SEO Framework and Slim SEO, for posts and taxonomy terms. One must be active for meta features.
• Page builders — text is extracted from Gutenberg, Classic editor, Elementor, Breakdance, Bricks, Divi, Oxygen, Beaver Builder and WPBakery.
• Custom fields — ACF fields including repeaters, groups and flexible content.
• WooCommerce — products, product categories and product tags.
• Developers — builder template post types are hidden by default; adjust the list with the snippetsense_excluded_post_types filter.

Troubleshooting

“Content is too short”

The page is below your minimum content length. Lower it in settings (0 processes everything). If a long page-builder page still reports this, contact us so we can check how its content is stored.

Rate limit or server errors

Snippet Sense retries rate-limit (429) and server (5xx) errors up to three times automatically. If errors continue, check your provider account has credit and higher rate limits, or switch to another model.

Invalid API key

Re-copy the key without spaces, make sure it belongs to the provider you selected, and confirm billing is enabled on your provider account.

Meta not appearing in my SEO plugin

Check that one of the six supported SEO plugins is active. Clear any page or object cache, then reload the editor to see the saved values.

TLDR or FAQ not showing

Check the site-wide switch in settings and the per-post toggle. If your theme or builder doesn't output standard post content, use manual placement with the shortcodes above.

Installation & licence

1. Download Link Sense from
   My Account
   .
2. Go to Plugins → Add New → Upload Plugin, install and activate it.
3. Enter your licence key on the Link Sense licence screen to enable automatic updates.

The linking engine works without an AI key or Search Console. AI suggestions, Search Console and AI agents are optional extras. AI agent abilities need WordPress 6.9 or later; everything else works on earlier versions.

Global settings

Under Link Sense → Settings, set the defaults and site-wide limits:

• Master switch — turn all automatic linking on or off.
• Global link cap — maximum automatic links per page across all keywords (0 = unlimited).
• Links to the same page — how many auto-links one URL can receive on a single page, across all keywords (default 1; 0 = no limit).
• Anchor variety — when several keywords point at the same page, each page tries them in a different order so anchors vary (on by default).
• Target coverage — the share of pages allowed to auto-link to any one page (default 100%).
• Defaults for new keywords — new tab and rel values, excluded HTML elements and CSS classes, and post types (posts only out of the box).
• AI provider — optional: OpenAI, Google Gemini, Anthropic or OpenRouter, plus custom instructions for every AI prompt.

Keyword rules

Add a keyword from the keyword list and choose where it should link. Each rule supports:

• URL — any internal or external address, including affiliate links. For internal pages, the keyword remembers the page itself, so the link follows it if its URL changes.
• Max uses per page — 1 to 100.
• Priority — higher-priority keywords are processed first.
• Matching — whole-word matching, with optional case sensitivity.
• Attributes — new tab (noopener and noreferrer added automatically), nofollow, sponsored, ugc, title/tooltip, CSS classes and ARIA label.
• Excluded elements — 22 options including H1–H6, buttons, blockquotes, code, tables, captions, strong and em.
• Targeting — post types, specific posts to include or exclude, and categories or tags to include or exclude.

Use bulk actions to activate, deactivate or delete several rules at once. The Source column shows whether a rule was added manually, from an AI suggestion or from Search Console, and old-domain links are badged in the list.

AI suggestions & models

• Scan Content — scans all posts of the chosen types, or a single post, and suggests keyword → URL pairs (10 per post by default, 3–20 configurable), each with a confidence score and reason.
• Suggestions queue — accept, edit and accept, or dismiss suggestions individually or in bulk. Accept all high-confidence adds everything scoring 80 or more.
• Variations — generate 5–8 alternative phrasings for a keyword and see how many published posts contain each one.
• Auto-suggest on publish — when a post is published, Link Sense looks for links both to it and from it, in the background.

Supported models

• OpenAI — GPT-5.4 Mini, GPT-5.4 Nano and GPT-5.5.
• Google Gemini — Gemini 3.5 Flash, 3.5 Flash-Lite, 3.1 Flash-Lite and 3.1 Pro Preview.
• Anthropic — Claude Sonnet 5.5, Sonnet 5, Haiku 4.5 and Opus 5.5.
• OpenRouter — a selection of current models from each provider through one key.
• Other model ID… — enter any newly released model ID to use it without waiting for a plugin update.

If your settings used a retired model (for example Gemini 2.5 Flash, Claude Sonnet 4 or GPT-4.1), Link Sense switches to its current replacement automatically. Your Gemini API key is sent in a request header, never in the URL.

Search Console

• Google Site Kit — if Site Kit is already connected to Search Console, Link Sense reuses that connection with no extra setup.
• Service account — create a Google Cloud service account, download its JSON key, add the service account's email address as a user on your Search Console property, then paste the key into Link Sense's Search Console settings.
• Connection method — choose Automatic (uses whichever connection is available), Google Site Kit or Service account. Your property is detected automatically, and the first sync imports 90 days of history.

• Opportunities — searches your pages already rank for (positions 4–20 by default) that aren't keywords yet. Add a keyword or dismiss each one with one click. Adjust the position range and minimum impressions to suit your site.
• Impact — clicks, impressions and average position for each linked page, compared over equal periods before and after its keywords started linking to it.
• Sync — runs daily in the background, or on demand with Sync now.

Link Graph

The Link Graph maps the internal links inside each page's content — both links you wrote and links Link Sense adds. Headers, footers, menus, sidebars and automatic post lists are ignored. It works with Breakdance, Oxygen and Bricks as well as classic and block themes.

• Index all pages — builds the graph on demand. After that, pages refresh automatically once a day as visitors view them.
• Orphan pages — pages with no incoming links, each with a suggested anchor (its top search query when Search Console is connected) and one-click Add keyword. Utility pages such as privacy, cart, checkout and account pages, and pages noindexed in Yoast or Rank Math, are left out. Developers can exclude more with the alk_graph_orphan_exclude_ids filter.
• Most linked pages — shows each page's anchor mix and flags it as over-optimised when one anchor dominates.

Link Health

Link Sense keeps automatic links pointing at the right place:

• Self-healing — keywords remember the page they link to, so if its URL changes, the links follow automatically.
• No links to 404s — links to draft, private, trashed or deleted pages are skipped.
• Link Health tab — flags moved, unpublished, deleted, unverified and old-domain links.
• Site migrations — links left pointing at an old domain are detected and can be repaired in one click, per domain or per keyword.

AI agents (MCP)

Link Sense can be managed by AI agents such as Claude through the WordPress Abilities API and the MCP Adapter plugin (WordPress 6.9+). The AI Agents (MCP) settings section shows whether the Abilities API and MCP Adapter are available, your MCP endpoint, and an on/off switch.

• list-keywords, add-keyword, update-keyword, delete-keyword — manage keyword rules.
• get-link-health, repair-links — find and fix moved, unpublished and old-domain links.
• get-link-graph — orphan pages and most-linked pages.
• get-search-opportunities, get-page-search-queries, get-keyword-impact — Search Console insights.

All abilities require an administrator account. Agents work through Link Sense's rules, so duplicate checks, defaults and limits still apply.

Block editor panel

In the block editor sidebar, the Link Sense panel shows a live preview of which keywords will be linked and how many times, updating as you type. It also lists AI suggestions for the post, and a toggle to disable automatic linking for that post only.

How linking works

Link Sense adds links as each single post or page is displayed. Each page is scanned once, keywords that don't appear are skipped instantly, and links are spread evenly through the content — up to 250× faster than before on large page-builder layouts. It never links inside existing links and pages never link to themselves. Headers, footers, navigation, sidebars, widgets, menus and breadcrumbs are skipped automatically.

Because nothing is saved into your posts, changing a rule updates every page instantly, and deactivating the plugin removes all automatic links. Linking doesn't run in the admin, feeds, previews or REST requests.

Troubleshooting

A keyword isn't being linked

Check that the rule is active, the post type is included, the post isn't excluded by targeting, the per-post toggle is on, and the global cap, “Links to the same page” and target coverage limits haven't been reached. Whole-word matching means “boot” won't match “boots”; add a variation instead.

Fewer links than before 2.2

“Links to the same page” now defaults to 1, so multiple keywords pointing at one page produce a single link. Set it to 0 to allow more.

Links don't appear on the live page

Links aren't added in previews. View the published page logged out and clear any page cache after changing rules.

Search Console returns an error

Make sure the service account's email address has been added as a user on the correct Search Console property.

Getting support

Every licence includes 12 months of premium support. If you're stuck, contact us with your site URL, plugin version and a description of the issue, and we'll help you get it sorted. You can also check the FAQs and the changelog.