How to Use Keyword Auto-Linking

Automatically convert keywords and phrases in your content into affiliate links with LegendLinks keyword auto-linking feature.

Overview

Keyword auto-linking automatically finds and converts specified keywords in your content into affiliate links. This saves time and ensures consistent linking across your site.

What is Keyword Auto-Linking?

Auto-linking scans your content and replaces matching keywords with links to your affiliate offers. For example, "Nike shoes" could automatically become a link to your Nike affiliate offer.

Key Benefits

• ⚡ Time Saving: No manual linking needed
• 🎯 Consistent: Ensures all instances are linked
• 📈 Monetization: Automatically adds affiliate opportunities
• 🎛️ Control: Full control over what gets linked
• 📊 Analytics: Track which keywords perform best

How Keyword Auto-Linking Works

Keyword Matching Process

// Content: "I love Nike shoes, they're the best running shoes"
// Keywords: ["Nike shoes", "running shoes"]
// Result: "I love <a href="yoursite.com/go/nike">Nike shoes</a>, they're the best <a href="yoursite.com/go/running">running shoes</a>"

Smart Processing

• Whole Words Only: Avoids partial matches
• Case Insensitive: Works with any capitalization
• Priority Order: Processes rules in order
• No Double-Linking: Won't link already linked text
• Context Aware: Respects existing HTML structure

Requirements

• ✅ LegendLinks Pro/Plus/Business Plan (auto-linking is a premium feature)
• ✅ Auto-Linking Enabled: Must be activated in settings
• ✅ Keyword Rules: Need to create linking rules

How to Enable Auto-Linking

Step 1: Access Settings

1. Go to LegendLinks → Settings in your WordPress admin
2. Click on the "General" tab

Step 2: Enable Auto-Linking

Find the "Keyword Auto-Linking" setting:

✅ Enable Keyword Auto-Linking: ON

Step 3: Configure Rules

Go to LegendLinks → Auto Links to create linking rules.

Creating Auto-Link Rules

Step 1: Access Auto Links

1. Go to LegendLinks → Auto Links in your WordPress admin
2. Click "+ Add New Rule"

Step 2: Configure Rule

Basic Settings

• Rule Name: Nike Running Shoes
• Keywords: Nike shoes, running shoes, Nike running
• Target Link: Select or create link to your Nike affiliate offer
• Status: Active

Advanced Options

• Case Sensitive: Usually No (case insensitive)
• Limit Replacements: 0 (unlimited) or set maximum per page
• Priority: 10 (higher numbers = higher priority)

Step 3: Save Rule

Click "Save Rule" to activate auto-linking.

Step-by-Step Examples

Example 1: Product Linking

Create Rule

Rule Name: Amazon Kindle
Keywords: Kindle, Amazon Kindle, Kindle Paperwhite
Target: yoursite.com/go/kindle-affiliate
Priority: 10

Content Before

I just bought a new Kindle Paperwhite and love it!

Content After

I just bought a new <a href="yoursite.com/go/kindle-affiliate">Kindle Paperwhite</a> and love it!

Example 2: Brand Linking

Create Rule

Rule Name: Shopify
Keywords: Shopify, Shopify store, Shopify website
Target: yoursite.com/go/shopify-affiliate
Priority: 5

Multiple Matches

Original: "Shopify store Shopify website"
Result: "<a href="yoursite.com/go/shopify-affiliate">Shopify store</a> <a href="yoursite.com/go/shopify-affiliate">Shopify website</a>"

Example 3: Service Linking

Create Rule

Rule Name: Web Hosting
Keywords: web hosting, hosting provider, host website
Target: yoursite.com/go/hosting-affiliate
Priority: 8
Limit: 2 (maximum 2 links per page)

Advanced Configuration

Priority System

Rules with higher priority numbers are processed first:

Priority 10: "Nike shoes" → Link A (processed first)
Priority 5:  "Nike" → Link B (processed second, skips already linked)
Result: "<a>Nike shoes</a>" (only first rule applies)

Limit Replacements

Control how many times a keyword gets linked per page:

Rule: "hosting"
Limit: 3
Content: "hosting hosting hosting hosting hosting"
Result: "<a>hosting</a> <a>hosting</a> <a>hosting</a> hosting hosting"

Case Sensitivity

Case Sensitive: Yes
Keywords: "WordPress"
Matches: "WordPress" ✅, "wordpress" ❌

Case Sensitive: No (default)
Keywords: "WordPress"
Matches: "WordPress" ✅, "wordpress" ✅, "WORDPRESS" ✅

Testing Auto-Linking

Test 1: Basic Functionality

1. Create rule: Keyword "test product" → link to test offer
2. Create post: Write "I recommend test product for everyone"
3. Publish: View post and verify link was added
4. Click test: Ensure link redirects properly

Test 2: Priority Testing

1. Create two rules with different priorities
2. Overlapping keywords: "best shoes" (priority 10), "shoes" (priority 5)
3. Test content: "best shoes are great"
4. Expected: Only "best shoes" gets linked (higher priority wins)

Test 3: Limit Testing

1. Set limit: 2 replacements per page
2. Keyword: "amazing"
3. Content: "amazing amazing amazing amazing"
4. Expected: Only first two instances linked

Content Type Support

Supported Content

• ✅ Posts: All post types
• ✅ Pages: Standard pages
• ✅ Custom Post Types: WooCommerce products, etc.
• ✅ Comments: Optional (can be enabled/disabled)
• ✅ Excerpts: Teaser content

Excluded Content

• ❌ Titles: Post/page titles
• ❌ Menus: Navigation menus
• ❌ Widgets: Sidebar widgets
• ❌ Headers/Footers: Template areas
• ❌ Admin Areas: WordPress admin interface

Performance Optimization

Processing Efficiency

• Lazy Loading: Only processes when content is displayed
• Caching: Results cached for performance
• Selective Processing: Only runs on configured post types
• Memory Efficient: Minimal memory usage

Best Practices

1. Limit Rules: Don't create hundreds of rules
2. Specific Keywords: Use specific phrases over single words
3. Regular Audits: Remove unused rules
4. Test Performance: Monitor page load times

Troubleshooting

Auto-Linking Not Working

Symptoms: Keywords not being converted to links Solutions:

• ✅ Verify auto-linking is enabled in settings
• ✅ Check Pro/Plus/Business plan is active
• ✅ Ensure rule status is "Active"
• ✅ Clear WordPress cache
• ✅ Test on published content (not preview)

Wrong Links Being Created

Symptoms: Wrong keywords getting linked or wrong targets Solutions:

• ✅ Check rule priorities (higher = processed first)
• ✅ Verify keyword specificity
• ✅ Test with simple keywords first
• ✅ Check for conflicting rules

Links Not Appearing in Content

Symptoms: Rules exist but no links in published content Solutions:

• ✅ Publish content (auto-linking doesn't work in drafts/previews)
• ✅ Check post type support
• ✅ Verify user permissions
• ✅ Test with different content

Performance Issues

Symptoms: Slow page loads after enabling auto-linking Solutions:

• ✅ Reduce number of rules
• ✅ Use more specific keywords
• ✅ Enable caching
• ✅ Monitor database queries

Advanced Use Cases

E-commerce Integration

// Product mentions
Keywords: "wireless headphones, Bluetooth speaker, smart watch"
Target: Affiliate product links
Result: Automatic product linking in blog posts

Brand Mention Linking

// Brand keywords
Keywords: "Apple, Samsung, Google, Microsoft"
Target: Brand affiliate pages
Result: Automatic brand linking in reviews

Service Linking

// Service keywords
Keywords: "web hosting, email marketing, SEO service"
Target: Service affiliate offers
Result: Automatic service linking in tutorials

Content Category Linking

// Category-based linking
Fitness content: "protein powder, workout supplements"
Tech content: "laptop, smartphone, tablet"
Result: Contextual linking based on content type

Analytics and Reporting

Performance Tracking

Access auto-linking analytics in LegendLinks → Analytics:

Available Metrics

• Links Generated: How many auto-links created
• Click Performance: Which auto-links get clicked
• Keyword Performance: Best performing keywords
• Content Effectiveness: Which posts generate most links

A/B Testing

Test different auto-linking strategies:

Version A: "buy now" → Direct affiliate link
Version B: "buy now" → Landing page first
Compare: Click-through rates and conversions

Best Practices

✅ Implementation Tips

1. Start Small: Begin with 5-10 important keywords
2. Be Specific: Use phrases like "wireless headphones" not just "headphones"
3. Test Thoroughly: Check all content types and scenarios
4. Monitor Performance: Track which rules work best
5. Update Regularly: Refresh keywords based on trends

✅ Content Quality

1. Natural Integration: Don't over-link (avoid link spam)
2. Context Matters: Ensure links add value to content
3. User Experience: Links should enhance, not distract
4. Compliance: Follow affiliate disclosure requirements

⚠️ Important Considerations

SEO Impact

• Over-linking: Can be seen as spammy by search engines
• Relevance: Ensure links are contextually appropriate
• Value: Links should provide genuine value to readers

Performance

• Page Speed: Too many rules can slow page generation
• Database Load: Complex rules increase processing time
• Caching: Ensure compatibility with caching plugins

Content Quality

• Readability: Don't create link clusters
• Disclosure: Use clear affiliate disclaimers
• Trust: Maintain reader trust with honest linking

Frequently Asked Questions

Does it work on existing content?

Yes. Auto-linking processes both new and existing published content. Just republish old posts to apply new rules.

Can I exclude certain content?

Yes. Configure which post types and content areas to process in settings.

What about internal links?

Smart detection. Auto-linking avoids linking already linked text and respects existing HTML structure.

Can I use HTML in keywords?

No. Keywords should be plain text. HTML tags are automatically handled.

Does it work with page builders?

Most. Works with Gutenberg, Classic Editor, and most page builders. Some complex layouts may need testing.

Can I limit links per page?

Yes. Set "Limit Replacements" in each rule to control maximum links per page.

What about mobile performance?

Optimized. Auto-linking is processed server-side and cached for optimal mobile performance.

Can I export/import rules?

Currently manual. Rules can be recreated in different installations.

Related Documentation

• Creating Links - Manual link creation
• Settings - Auto-linking configuration
• Analytics - Performance tracking

Need help? Check our FAQ or contact support.