Skip to main content
WordPress Integration

Set up the Similar AI internal linking plugin for WordPress

Install the plugin, configure a Gutenberg block with your API credentials, and deploy internal links across your WordPress site using reusable patterns.

Robin AllensonBy Robin Allenson, CEO & Co-Founder
Request a demo

Step 1 - Install the plugin

Log in to your WordPress admin dashboard and follow these steps to install the Similar AI internal linking plugin.

  1. a.Click Plugins in the left navigation, then click Add New.
  2. b.Click Upload Plugin and select the Similar AI plugin file provided by your account manager.
  3. c.Once the upload completes, click Activate to enable the plugin.

Step 2 - Add an internal linking block to a page

When creating or editing a post or page, add a Similar AI internal linking block through the Gutenberg editor. The block connects to the Similar AI service and displays related searches for the current page.

Fill in the block settings with these fields:

API Key

Go to the Internal Linking view in the Similar AI dashboard. Enter a test page URL and look for the X-API-KEY value in the JSON request.

API URL

Use the default endpoint unless your Customer Success manager has provided a different one:

https://isentropic-snow-282609.ew.r.appspot.com/api/seo-related-searches/

Test URL

Enter any page from your site to verify the block is working correctly.

Position

Leave this as the default. If you have multiple internal linking modules on a single page, set the position number to choose which module to display.

Step 3 - Deploy to multiple pages with reusable patterns

To add the internal linking block across your entire site without editing each page individually, create a reusable block (called a Pattern in current WordPress versions) and embed it in your theme template.

  1. a.Create a reusable block containing the Similar AI internal linking block you configured in Step 2.
  2. b.Note the post ID of the reusable block. You can find this in the URL when editing the block, or by querying wp_posts for blocks of type wp_block.
  3. c.Add the following snippet to your theme template (e.g. footer.php), replacing 1102 with your reusable block post ID:
<div class="grid-container">
    <h5 class="similarai-linking-header px-2 py-4">Related Links</h5>
    <div id="similarai-block">
        <?php $reusable_block = get_post( 1102 ); echo do_blocks( $reusable_block->post_content ); ?>
    </div>
</div>

Replace the post ID 1102 with the actual ID of your reusable block. Using the wrong ID will render an empty container.

Related guides

Depending on your WordPress setup, these guides may also be helpful:

Frequently asked questions

How do I install the Similar AI WordPress plugin for internal linking?

You can install the Similar AI plugin directly from the WordPress plugin directory or by uploading the plugin zip file through your dashboard. Once activated, navigate to the plugin settings to enter your API key and connect your site to the Similar AI platform, where the Linking Agent will begin analyzing your content.

Does the Similar AI plugin work with the Gutenberg block editor?

Yes, the plugin includes a dedicated Gutenberg block that lets you embed and manage internal link suggestions directly within the block editor. You can configure reusable block patterns for consistent deployment across multiple page templates, saving significant setup time on large catalogs.

How does the Linking Agent decide which internal links to add to my pages?

The Linking Agent maps topical relationships across your product, category, and editorial pages to identify high-value linking opportunities that strengthen your site's authority structure. It prioritizes links that improve crawlability and pass relevance signals between related pages, and all suggestions can be reviewed before publishing.

Can I deploy internal linking patterns across thousands of product pages at once?

The plugin supports reusable patterns that apply consistent linking logic across your entire catalog without requiring page-by-page manual edits. This is especially useful for omni-channel retailers with 3,000 or more products, where the Linking Agent can automate the bulk of deployment after initial configuration.

What API configuration is needed to connect WordPress to Similar AI?

After installing the plugin, you'll enter your Similar AI API key in the plugin's settings panel to authenticate your site. The setup guide walks through endpoint configuration and any optional parameters, such as language or category filters, so the Linking Agent focuses on the most relevant sections of your store.

Ready to automate internal linking on WordPress?

Get the Similar AI plugin installed and start connecting your pages with relevant internal links. Our team can walk you through the setup.