Troubleshooting

Quick solutions to common problems.

Quick Fixes

Try these first:

1. Clear all caches - Browser, WordPress, and server
2. Flush permalinks - Go to WordPress Dashboard → Settings → Permalinks, click Save Changes
3. Deactivate other plugins - Check for conflicts
4. Update WordPress - Make sure everything is current
5. Try a different browser - Rule out browser-specific issues

Links Not Working

Link shows 404 error

1. Check link status is Published (not Draft)
2. Go to WordPress Dashboard → Settings → Permalinks, click Save Changes
3. Clear your cache
4. Check slug doesn't have special characters

Link redirects to wrong URL

1. Edit link and verify destination URL
2. Check for redirect plugin conflicts
3. Clear all caches including CDN

Tracking Issues

Clicks not recording

1. Go to Settings, verify Click Tracking is enabled
2. If "Track Logged-in Users" is off, your clicks won't count
3. Test link and wait a few minutes
4. Check data retention setting (old data may be deleted)

Click count seems too high

• Likely bot traffic - check analytics for patterns
• Install a security plugin to block bots
• Turn off "Track Logged-in Users" to exclude your own clicks

Auto-Linking Issues

Auto-links not appearing

1. Check if auto-linking is enabled in Settings
2. Verify rule is active (not paused)
3. Check keyword spelling matches exactly
4. Ensure "Maximum Links Per Post" limit isn't reached

Too many auto-links

1. Reduce "Maximum Links Per Post" in Settings (try 3-5)
2. Make keywords case sensitive
3. Use longer, more specific keywords
4. Pause or delete unnecessary rules

Performance Issues

Site slower after installing

1. Reduce health check frequency (daily → weekly)
2. Reduce data retention period in Settings
3. Clean up old click data
4. Consider upgrading hosting if you have thousands of links

Installation Issues

Can't install plugin

1. Check file permissions (contact hosting provider)
2. Upload manually via FTP to /wp-content/plugins/
3. Increase PHP memory limit in wp-config.php:

   define( 'WP_MEMORY_LIMIT', '256M' );

Import/Export Issues

Import fails

1. Check CSV format (comma-separated, correct headers)
2. Ensure file is UTF-8 encoded
3. Split large files into smaller batches (500-1000 links)

Export has no data

1. Check date range selection
2. Clear all filters
3. Verify you have admin access

Common Error Messages

Error	Solution
Link already exists	Choose a different slug
Invalid destination URL	Check URL format (must start with http:// or https://)
Permission denied	Make sure you're logged in as Administrator

Still Need Help?

1. Check our FAQ
2. Contact support with:
   • WordPress version
   • Plugin version
   • PHP version
   • Error messages or screenshots
   • Steps to reproduce the issue