Internal Post Linker – Link Internal Posts, Pages, Products without leaving the page

Internal Post Linker helps editors create internal links while writing. Select text in the editor, open the internal link search, choose an existing site result, and the plugin applies the selected result’s permalink to the selected text.

The plugin supports the WordPress block editor and the Classic Editor/TinyMCE visual editor. Search results include useful context before insertion, including title, post type, publication date, excerpt, privacy status, current-post label, and a preview link.

Key Features

• Link selected text to posts, pages, and public custom post types.
• Scan the current article for internal link suggestions.
• Works in the block editor and Classic Editor/TinyMCE visual editor.
• Searches linkable content by title and slug.
• Shows result title, post type, date, excerpt, private status, and current-post label.
• Adds WordPress editor link metadata so newly inserted block editor links display correctly.
• Uses nonce-protected admin-ajax requests for editor search.
• Includes a REST search endpoint for editor integrations.
• Supports older block editor builds that expose toolbar APIs through wp.editor.
• Excludes attachments from link targets.
• Works without a build step.

Using It In The Block Editor

1. Open a post, page, or supported custom post type in the WordPress block editor.
2. Click inside a text block, such as a Paragraph, Heading, List, or other rich text block.
3. Highlight the text you want to link.
4. Click the Internal Post Link toolbar button.
5. In the modal, search for the page, post, or article you want to link.
6. Review the search results.
7. Click the result you want.
8. The selected text is linked immediately.
9. Save, update, or publish the post as usual.

Suggest Internal Links

The Suggest internal links feature helps editors find internal linking opportunities before publishing. Instead of manually searching for every possible link, editors can scan the current article and review a list of suggested keywords that match existing internal content.

This feature is not AI generated. It uses deterministic matching against existing site content, including:

• Post titles.
• Page titles.
• Product titles when products are available as a public post type.
• Public custom post type titles.
• URL slugs converted into readable phrases.
• Strong one-word, two-word, three-word, and longer title phrases, excluding common filler words.

The scanner ignores text that is already linked, so it focuses on unlinked opportunities in the current article.

How To Use Suggestions In The Block Editor

1. Open a post, page, or supported custom post type in the WordPress block editor.
2. Write or edit the article content.
3. Click the Suggest internal links icon near the editor publish controls.
4. Review the suggested keywords and target articles.
5. Use the suggestion search field to filter the list by keyword, target title, content type, or excerpt.
6. Click Apply to link one suggestion.
7. Click Apply all to apply all available non-current-article suggestions in the current filtered list.
8. Save, update, or publish the post as usual.

How To Use Suggestions In Classic Editor

1. Open a post or page in Classic Editor.
2. Make sure you are using the Visual editor tab.
3. Write or edit the article content.
4. In the publish box, click Suggest internal links.
5. Review the suggested keywords and target articles.
6. Use the suggestion search field to filter the list by keyword, target title, content type, or excerpt.
7. Click Apply to link one suggestion.
8. Click Apply all to apply all available non-current-article suggestions in the current filtered list.
9. Save, update, or publish the post as usual.

Suggestion Details

Each suggestion can include:

• The suggested target title.
• The matched keyword or phrase.
• The target content type, such as Post, Page, Product, or another public custom post type.
• The number of times the keyword appears in the current article.
• A short excerpt from the suggested target.
• Highlighted keyword matches in the title, metadata, and excerpt.
• A quality rating: Normal, Good, Best, or Ideal.

Suggestion ratings are calculated without AI. Ratings are based on match strength signals such as keyword occurrence count, keyword length, and whether the keyword appears in the suggested target title, slug, or excerpt. Higher-rated suggestions are shown first.

Ratings also check the suggested target article body content on the server. If the keyword appears in the target article content, the suggestion receives an additional relevance boost. The target article body is not returned to the browser; only the suggestion metadata and match count are shown.

Applying Suggestions

Clicking Apply links the first available unlinked occurrence of the suggested keyword in the current article.

Clicking Apply all applies all available suggestions in the current filtered list, skipping current-article suggestions. After a successful bulk apply, the suggestion modal closes automatically.

Current-article suggestions are highlighted so editors can identify possible self-links. They are not applied by Apply all, because linking an article to itself is usually not useful.

Using It In Classic Editor

1. Open a post or page in Classic Editor.
2. Make sure you are using the Visual editor tab.
3. Highlight the text you want to link.
4. Click the Internal Link button in the editor toolbar.
5. Search for the internal content you want to link.
6. Click a result.
7. The selected text is linked immediately.
8. Save, update, or publish the post as usual.

Search Results

Each result can show:

• Title.
• Content type, such as Post, Page, or a custom post type label.
• Published date.
• Excerpt.
• Private status, when applicable.
• Current post label, when the matching result is the post currently being edited.
• A preview link where available.

The plugin searches titles and slugs. For best results, search using words from the target content title.

Examples:

• Product Name
• Gravity Forms
• Documentation
• REST API

Linking To The Current Post

The current post may appear in search results if it matches the search term. It is labeled Current post so editors can identify it before linking.

In most editorial workflows, linking a post to itself is not useful. If you see the Current post label, choose a different result unless you intentionally want a self-link.

Updating An Existing Link

In the block editor:

1. Click or select the already linked text.
2. Open Internal Post Link.
3. Search for the replacement content.
4. Click the new result.

The existing link is replaced with the selected internal link.

In Classic Editor:

1. Select the linked text.
2. Click Internal Link.
3. Search and choose the replacement result.

Removing A Link

The plugin focuses on finding and applying internal links. To remove a link, use the editor’s standard unlink control:

• In the block editor, click the linked text and use the unlink option in the link popover or toolbar.
• In Classic Editor, select the linked text and click the standard unlink toolbar button.

Search Security

Search requests are protected with WordPress permissions and nonces. The plugin only returns search results for logged-in users who can edit posts.

The plugin does not expose internal search to public site visitors.

Supported Content Types

The plugin searches public post types that have an editor UI, including:

• Posts.
• Pages.
• Public custom post types.
• Knowledge base articles, documentation articles, or other public editor-backed content types when registered by your site.

Attachments are excluded from search results.