wordpress/WordPress Troubleshooting

WordPress Troubleshooting

Solutions to common issues when using Intufind with WordPress.

Widget Issues

Widget not appearing

Possible causes:

  1. Widget disabled — Check Intufind → Settings and ensure "Enable Widget" is on
  2. JavaScript error — Open browser console (F12) and check for errors
  3. Caching — Clear your cache plugin and browser cache
  4. Theme conflict — Try switching to a default theme temporarily

Solution steps:

  1. Clear all caches (plugin, CDN, browser)
  2. Disable other plugins one by one to identify conflicts
  3. Check if widget appears in a default theme

Widget in wrong position

  1. Go to Intufind → Appearance
  2. Adjust the Position setting
  3. Save and clear cache

Widget not loading on mobile

  1. Check if you have mobile-specific caching
  2. Ensure widget isn't hidden via CSS media queries
  3. Try in incognito/private browsing mode

Sync Issues

Products not syncing

Check:

  1. Products are published (not draft)
  2. Products are not in an excluded category
  3. Your API connection is active

Force sync:

  1. Go to Intufind → Indexing
  2. Click Clear Index
  3. Click Sync All

Sync stuck or slow

For large catalogs (10,000+ products):

  1. Sync runs in batches automatically
  2. Don't navigate away during sync
  3. Check server resources (memory, timeout limits)

Changes not reflected

After editing products:

  1. Wait 1-2 minutes for auto-sync
  2. Or manually sync the product from edit screen
  3. Clear any result caching

Connection Issues

"License key invalid" error

  1. Copy key directly from dashboard (avoid extra spaces)
  2. Ensure subscription is active
  3. Check API key hasn't expired
  4. Try deactivating and reactivating

"Could not connect to server"

  1. Check your server allows outbound HTTPS requests
  2. Verify firewall isn't blocking api.intufind.com
  3. Try from a different network

Timeout errors

  1. Increase PHP timeout limits
  2. Check server isn't rate-limiting requests
  3. Contact support if persistent

Performance Issues

Slow search responses

  1. Check your internet connection
  2. Verify server isn't overloaded
  3. Consider upgrading plan for faster limits

High server load

  1. Enable lazy-loading for widget
  2. Use caching for repeat queries
  3. Check for runaway sync processes

Plugin Conflicts

Known incompatibilities

Some plugins may conflict:

  • Security plugins blocking API requests
  • Optimization plugins breaking JavaScript
  • Other search plugins conflicting

Solution: Whitelist Intufind in security plugins and exclude from JS optimization.

How to test conflicts

  1. Deactivate all plugins except Intufind and WooCommerce
  2. Check if issue persists
  3. Reactivate plugins one by one to identify conflict

Getting Help

If issues persist:

  1. Check status — status.intufind.com
  2. Search docs — Use the search in our documentation
  3. Contact support — Contact us with:
    • WordPress version
    • Theme name
    • Active plugins list
    • Error messages/screenshots

We typically respond within 24 hours.