WordPress Tutorial: How to Automatically Add Links to Keywords in Post Content

How It Works

By adding a custom function to WordPress's the_content filter, you can automatically replace specified keywords with HTML anchor tags containing hyperlinks before the post content is displayed.

Code Example

Add the following code to the end of your current WordPress theme's functions.php file:

function replace_text_wps($text) {
    $replace = array(
        'Keyword 1' => '<a href="https://example.com/link1/" rel="tag">Keyword 1</a>',
        'Keyword 2' => '<a href="https://example.com/link2/" rel="category tag">Keyword 2</a>',
        'Keyword 3' => '<a href="https://example.com/link3/" rel="nofollow" target="_blank">Keyword 3</a>'
    );
    $text = str_replace(array_keys($replace), $replace, $text);
    return $text;
}
add_filter('the_content', 'replace_text_wps');

Code Explanation & Configuration

The core of the code is an associative array $replace that defines keywords and their corresponding links. Modify this array as needed:

• Key: The original keyword to replace (e.g., 'Keyword 1').
• Value: The full HTML link code to replace it with.

Within the link code, you can set these attributes:

• href: The target URL.
• rel: Defines the relationship of the link to the current document. Common values:
  • tag: Link points to a tag page.
  • category tag: Link points to a category or tag page.
  • nofollow: Tells search engines not to follow this link.
• target="_blank": Opens the link in a new browser tab.

Important Considerations

• Performance: This method performs a string replacement on all post content. A very long keyword list or extensive content may slightly impact performance.
• Avoid Over-Optimization: Use cautiously. Adding too many links for the same keyword in one post may be seen as spam by search engines.
• Use a Child Theme: It is strongly recommended to make this modification in your child theme's functions.php file to prevent code loss during theme updates.

Alternative Methods

Instead of manually adding code, you can use dedicated plugins:

• SEO Plugins: Many SEO plugins (e.g., Rank Math, Yoast SEO) include internal linking suggestions or auto-linking features.
• Dedicated Auto-Link Plugins: Search for "WordPress auto link keywords" to find relevant plugins.

Using a plugin is often easier to manage and provides a graphical interface for adding and editing keyword links.