Title: BASIX Auto Links
Author: chirobasix
Published: <strong>aprel 23, 2026</strong>
Last modified: aprel 23, 2026

---

Search plugins

![](https://ps.w.org/basix-auto-links/assets/banner-772x250.png?rev=3513746)

![](https://ps.w.org/basix-auto-links/assets/icon.svg?rev=3513746)

# BASIX Auto Links

 By [chirobasix](https://profiles.wordpress.org/chirobasix/)

[Download](https://downloads.wordpress.org/plugin/basix-auto-links.1.0.0.zip)

 * [Details](https://tuk.wordpress.org/plugins/basix-auto-links/#description)
 * [Reviews](https://tuk.wordpress.org/plugins/basix-auto-links/#reviews)
 *  [Installation](https://tuk.wordpress.org/plugins/basix-auto-links/#installation)
 * [Development](https://tuk.wordpress.org/plugins/basix-auto-links/#developers)

 [Support](https://wordpress.org/support/plugin/basix-auto-links/)

## Description

**BASIX Auto Links** automatically inserts internal links into your WordPress content.
Define keyword-to-URL rules, and the plugin scans every post and page — replacing
matching keywords with links to the pages you specify. It also links post titles
and taxonomy terms automatically.

Internal linking is one of the most effective (and most overlooked) SEO strategies.
This plugin handles it for you, so you can focus on creating content instead of 
manually linking every page.

#### How It Works

The plugin works in three layers, processed in order:

 1. **Custom Keyword Rules** — You define rules like `web design, website design, /
    services/web-design`. Whenever those keywords appear in your content, the plugin
    automatically links them to the URL you specified.
 2. **Post Title Matching** — The plugin scans your content for mentions of other post/
    page titles on your site and links them automatically.
 3. **Taxonomy Term Matching** — Category and tag names found in your content are linked
    to their archive pages.

Links are inserted at display time — your actual post content in the database is
never modified.

#### Key Features

 * **Custom keyword-to-URL rules** — Map any keyword or phrase to any internal URL
 * **Post title auto-linking** — Automatically link mentions of your other posts
   and pages
 * **Taxonomy auto-linking** — Link category and tag mentions to their archive pages
 * **AI-powered suggestions (optional)** — Use Claude (Anthropic) or OpenAI to scan
   your site and automatically discover linking opportunities
 * **Smart duplicate prevention** — Prevents the same keyword from being linked 
   multiple times on one page
 * **Configurable link limits** — Set max links per page and per keyword
 * **Heading protection** — Never inserts links inside h1-h6 headings
 * **Image caption protection** — Skips links inside figcaption elements
 * **Self-link prevention** — Never links a page to itself
 * **Dead link prevention** — Automatically skips rules pointing to URLs that do
   not exist on your site
 * **WooCommerce compatible** — Automatically skips cart, checkout, and account 
   pages
 * **Noindex exclusion** — Optionally exclude noindex posts from being linked to(
   Yoast and SmartCrawl supported)
 * **Custom post type support** — Works with any public post type
 * **Per-post exclusion** — Disable auto-linking on individual posts via post meta
 * **Case-sensitive or insensitive matching**
 * **Wildcard URL exclusions** — Exclude entire URL patterns from processing
 * **RSS feed support** — Optionally process RSS feeds
 * **Open in new tab and nofollow options**
 * **Divi theme compatible**
 * **Object cache friendly** — Results are cached for performance
 * **Import / Export settings** — Move your configuration between sites with a single
   JSON file

#### AI-Powered Link Discovery (Optional)

The AI feature is completely optional and requires your own API key. You can choose
between:

 * **Claude (Anthropic)** — Using Claude Sonnet 4 or Claude Haiku 4.5
 * **OpenAI** — Using GPT-4o, GPT-4o Mini, or GPT-4.1

The AI analyzes your site content inventory and suggests keyword-to-URL rules that
you can review and approve before they are applied.

#### About the Author

BASIX Auto Links is built and maintained by [CHIROBASIX](https://chirobasix.com/),
a chiropractic marketing agency focused on helping practices grow through better
websites, SEO, and patient-generation systems. We built this plugin to automate 
the internal linking work our team does for client sites — and released it free 
so any WordPress site can benefit.

Learn more about CHIROBASIX at [https://chirobasix.com/](https://chirobasix.com/).

### External services

This plugin does NOT connect to any external service by default. All core functionality(
keyword rules, post title linking, taxonomy linking) runs entirely on your own WordPress
site with no outbound requests.

The plugin only connects to an external AI service if you **opt in** by entering
an API key in the settings and manually clicking the “Scan Site for Link Suggestions”
button. You can choose one of two providers:

#### Anthropic Claude API

**What the service is and what it is used for:** Anthropic’s Claude API is a hosted
large language model used to analyze your site’s published content and suggest keyword-
to-URL linking rules.

**When data is sent:** Only when you have entered a Claude API key, selected “Claude(
Anthropic)” as the AI Provider, and clicked the “Scan Site for Link Suggestions”
button on the plugin’s settings page. No data is ever sent automatically or on a
schedule.

**What data is sent:** A one-time request containing your site’s home URL, the titles,
relative URLs, post types, and short excerpts (approximately 80 words) of your published
posts, pages, and custom post types (up to 500 items), plus the names and relative
URLs of your public taxonomy terms (up to 100 items). No private content, no user
data, no passwords, and no administrative information is sent.

**Provider links:**
 * Anthropic Terms of Service: https://www.anthropic.com/legal/
commercial-terms * Anthropic Privacy Policy: https://www.anthropic.com/legal/privacy

#### OpenAI API

**What the service is and what it is used for:** OpenAI’s API is a hosted large 
language model service used to analyze your site’s published content and suggest
keyword-to-URL linking rules.

**When data is sent:** Only when you have entered an OpenAI API key, selected “OpenAI”
as the AI Provider, and clicked the “Scan Site for Link Suggestions” button on the
plugin’s settings page. No data is ever sent automatically or on a schedule.

**What data is sent:** A one-time request containing your site’s home URL, the titles,
relative URLs, post types, and short excerpts (approximately 80 words) of your published
posts, pages, and custom post types (up to 500 items), plus the names and relative
URLs of your public taxonomy terms (up to 100 items). No private content, no user
data, no passwords, and no administrative information is sent.

**Provider links:**
 * OpenAI Terms of Use: https://openai.com/policies/terms-of-
use * OpenAI Privacy Policy: https://openai.com/policies/privacy-policy

### Step-by-Step Setup Guide

After activating the plugin, follow these steps to get the most out of it:

#### Step 1: Enable Auto-Linking

Go to **Settings > Auto Links**. The “Enable Automatic Linking” toggle should already
be on. If not, enable it and click **Save Settings**.

#### Step 2: Choose Which Content Types to Process

Under **Content Types to Process**, check the boxes for the content types where 
you want links automatically inserted. Most sites should check **Posts** and **Pages**
at minimum.

#### Step 3: Choose What to Link To

Under **Link To**, select which content types and taxonomies should be used as link
targets:

 * **Post Types** — Check “Posts” and “Pages” so that post titles found in your 
   content will be auto-linked. If you have custom post types (like Services or 
   Products), check those too.
 * **Taxonomies** — Check “Categories” and “Tags” to auto-link category and tag 
   names to their archive pages.

#### Step 4: Add Custom Keyword Rules

This is where the plugin really shines. Under **Custom Keyword Links**, add one 
rule per line in this format:

    ```
    keyword1, keyword2, /target-url
    ```

**Examples:**

    ```
    web design, website design, website development, /services/web-design
    SEO, search engine optimization, SEO services, /services/seo
    contact us, get in touch, /contact
    ```

**Tips:**
 * The last item on each line is always the URL — everything before it
is a keyword. * Use relative URLs (starting with /) so your rules survive domain
changes. * You can list multiple keyword variations on one line, separated by commas.*
The plugin automatically skips rules where the target URL does not exist, so you
can safely add rules in advance.

#### Step 5: Configure Link Limits

Under **Link Limits**, set:

 * **Max links per page** — How many auto-links should appear on a single page (
   recommended: 10-15).
 * **Max links per keyword** — How many times a single keyword can be linked on 
   one page (recommended: 1-2).

#### Step 6: Review Behavior Settings

The defaults work well for most sites. Key settings to review:

 * **Only link on single posts/pages** — Recommended ON. Prevents links from appearing
   on archive pages.
 * **Prevent duplicate links** — Recommended ON. Ensures each keyword is only linked
   once per page.
 * **Do not link inside headings** — Recommended ON. Keeps your headings clean.
 * **Exclude noindex posts** — Recommended ON if you use Yoast or SmartCrawl.

#### Step 7: Set Up Exclusions (Optional)

If there are keywords you never want linked, or specific posts/pages where auto-
linking should be disabled:

 * **Ignored keywords** — Enter comma-separated keywords to skip (e.g., `home, about`).
 * **Ignored posts/pages** — Enter post IDs or relative URLs. Supports wildcards(
   e.g., `/blog/*` to exclude all blog posts).

#### Step 8: Use AI Suggestions (Optional)

If you have a Claude or OpenAI API key:

 1. Select your preferred **AI Provider** (Claude or OpenAI).
 2. Enter your **API Key**.
 3. Choose a **Model** (the recommended option balances cost and quality).
 4. Click **Save Settings** first, then click **Scan Site for Link Suggestions**.
 5. Wait for the AI to analyze your content (this usually takes 30-60 seconds).
 6. Review the suggestions in the table that appears.
 7. Uncheck any suggestions you do not want.
 8. Click **Apply Selected** to add the approved rules to your Custom Keywords.

#### Step 9: Save and Verify

Click **Save Settings** to save your configuration. Visit your site’s frontend and
check that links are appearing correctly in your content.

## Screenshots

 * [[
 * Main settings page — configure which content types are linked and manage custom
   keyword rules.
 * [[
 * AI-powered link suggestion scanner — optionally use Claude or OpenAI to discover
   new internal linking opportunities.

## Installation

#### Automatic Installation

 1. Go to **Plugins > Add New** in your WordPress admin.
 2. Search for **BASIX Auto Links**.
 3. Click **Install Now**, then **Activate**.
 4. Go to **Settings > Auto Links** to configure.

#### Manual Installation

 1. Download the plugin ZIP file.
 2. Go to **Plugins > Add New > Upload Plugin** in your WordPress admin.
 3. Upload the ZIP file and click **Install Now**.
 4. Activate the plugin.
 5. Go to **Settings > Auto Links** to configure.

## FAQ

### Does this plugin modify my post content in the database?

No. Links are inserted at display time using WordPress content filters. Your actual
post content is never changed.

### Will this slow down my site?

The plugin uses WordPress object caching to minimize database queries. On most sites,
the performance impact is negligible. If you use a persistent object cache plugin(
like Redis or Memcached), results are cached even more efficiently.

### Can I disable auto-linking on a specific post?

Yes. Add a custom field with the key `_basix_al_exclude` and any truthy value (like`
1`) to any post where you want to disable auto-linking.

### Does it work with custom post types?

Yes. Any public custom post type registered on your site will appear in the settings
and can be used both as a content source (where links are inserted) and as a link
target.

### Do I need an AI API key to use this plugin?

No. The AI feature is completely optional. The plugin works perfectly with manual
keyword rules, post title matching, and taxonomy linking — no API key required.

### What happens if I delete a page that keyword rules point to?

The plugin automatically validates that target URLs exist before inserting links.
If a target page is deleted or unpublished, the corresponding rules are silently
skipped. No broken links will be created.

### Is it compatible with WooCommerce?

Yes. The plugin automatically skips WooCommerce cart, checkout, and account pages
to avoid interfering with the shopping experience.

### Is it compatible with Divi?

Yes. The plugin includes specific compatibility handling for the Divi theme builder.

### Can I use relative URLs in my keyword rules?

Yes, and it is recommended. Using relative URLs (like `/services/web-design` instead
of `https://example.com/services/web-design`) ensures your rules continue to work
if you change domains.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“BASIX Auto Links” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ chirobasix ](https://profiles.wordpress.org/chirobasix/)

[Translate “BASIX Auto Links” into your language.](https://translate.wordpress.org/projects/wp-plugins/basix-auto-links)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/basix-auto-links/),
check out the [SVN repository](https://plugins.svn.wordpress.org/basix-auto-links/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/basix-auto-links/)
by [RSS](https://plugins.trac.wordpress.org/log/basix-auto-links/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * Initial release.
 * Custom keyword-to-URL linking rules.
 * Automatic post title and taxonomy term linking.
 * AI-powered link discovery with Claude and OpenAI support.
 * Import and export settings as JSON for multi-site setups.
 * Configurable link limits, heading protection, and duplicate prevention.
 * WooCommerce and Divi compatibility.
 * Per-post exclusion support.
 * Dead link prevention with URL validation.

## Meta

 *  Version **1.0.0**
 *  Last updated **2 weeks ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/basix-auto-links/)
 * Tags
 * [auto links](https://tuk.wordpress.org/plugins/tags/auto-links/)[automatic linking](https://tuk.wordpress.org/plugins/tags/automatic-linking/)
   [internal linking](https://tuk.wordpress.org/plugins/tags/internal-linking/)[internal links](https://tuk.wordpress.org/plugins/tags/internal-links/)
   [seo](https://tuk.wordpress.org/plugins/tags/seo/)
 *  [Advanced View](https://tuk.wordpress.org/plugins/basix-auto-links/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/basix-auto-links/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/basix-auto-links/reviews/)

## Contributors

 *   [ chirobasix ](https://profiles.wordpress.org/chirobasix/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/basix-auto-links/)