BugWP logo BugWP
Back to Community
Home / Community / General

Troubleshooting Common Pretty Links Keyword Replacement Issues

14 threads Sep 16, 2025

Content

If you use the 'PrettyLinks – Affiliate Links, Link Branding, Link Tracking, Marketing and Stripe Payments Plugin' for automatic keyword replacement, you may occasionally encounter situations where your links don't appear as expected. This is a common point of discussion among users, and many issues have known workarounds. This guide compiles the most frequent problems and their solutions, based on community reports and findings.

Why Keyword Replacement Might Fail

Keyword replacement is a powerful feature, but it can be affected by conflicts with other plugins, server settings, or specific content formatting. The process of scanning and replacing text throughout your site can sometimes interact unexpectedly with other processes.

Common Problems and Their Solutions

1. Conflict with SEO and Social Media Plugins

One of the most prevalent causes of keyword replacement failure is a conflict with plugins that handle OpenGraph meta tags, such as Yoast SEO or Social Sharing Toolkit.

  • Symptom: Keyword links work on category pages and the homepage but disappear on single posts.
  • Solution: Try disabling OpenGraph or specific Twitter card settings within your SEO plugin. For Yoast SEO, navigate to SEO -> Social -> Twitter and disable the 'Add Twitter card meta data' option. This has resolved the issue for many users.

2. Issues with Special Characters

The replacement feature may not always correctly handle non-standard ASCII characters, such as German umlauts (ä, ö, ü) or ampersands (&).

  • Symptom: Keywords containing characters like ä, ö, ü, or & are not being linked.
  • Solution: This is a known limitation that has been reported to the 'PrettyLinks – Affiliate Links, Link Branding, Link Tracking, Marketing and Stripe Payments Plugin' team. As a workaround, consider creating keyword variations without the special characters or using a different keyword altogether.

3. Interference with Other Page Elements

The replacement process can sometimes break other plugins or modify content it shouldn't, such as comments or related posts.

  • Symptom: Comment content is being replaced with the wrong text, or a related posts plugin malfunctions.
  • Solution: A primary troubleshooting step is to limit where replacements occur. Go to your Pretty Links settings and find the replacement options. Try changing the 'Replace in Comments' setting to 'None' to see if it resolves issues with comment content. For conflicts with other plugins like related posts, you may need to experiment with other exclusion settings.

4. Server Performance and Cron Jobs

For sites with a large number of replacements or posts, the indexing feature (available in Pro versions) uses WordPress's built-in cron system (wp-cron) to process changes in the background.

  • Symptom: New replacements do not appear on posts for a day or two, or the site experiences temporary slow performance.
  • Solution: Ensure that wp-cron is enabled and functioning correctly on your server. This process is typically automatic, but if you have a high-traffic site, your server administrator may need to configure a real cron job to handle it more efficiently.

General Troubleshooting Steps

  1. Deactivate Other Plugins: The fastest way to identify a conflict is to temporarily deactivate all other plugins. If the keyword replacement starts working, reactivate your plugins one by one to find the culprit.
  2. Switch Themes: Temporarily switch to a default WordPress theme (like Twenty Twenty-Four) to rule out a theme-specific conflict.
  3. Check Settings: Double-check your replacement thresholds and settings. A high threshold might cause fewer links to be created than you expect.

By methodically working through these common issues, you can often restore full functionality to your affiliate linking strategy. The community has found that conflicts, particularly with SEO plugins, are a frequent but solvable obstacle.

Related Support Threads Support