CleverSearch
CleverSearch

Troubleshooting Guide

Common issues and solutions for CleverSearch integration. Follow these steps to resolve problems and optimize your setup.

Quick Debugging Steps
1

Enable Debug Mode

Turn on debug mode to see detailed logging

  • Add ?clever-search-debug=true to your URL
  • Or set DEBUG_MODE: true in script configuration
  • Check browser console for detailed logs
2

Check Network Requests

Verify API calls are working correctly

  • Open browser Developer Tools
  • Go to Network tab
  • Look for requests to /api/v1/tracker/
  • Check response status and content
3

Verify Configuration

Ensure all settings are correct

  • Check SITE_ID matches dashboard
  • Verify script URL is correct
  • Confirm page URL is in sitemap
  • Test with different browsers
4

Test Global API

Use the exposed global API for testing

  • Open browser console
  • Run window.LLMOptimizer.getStats()
  • Try window.LLMOptimizer.refresh()
  • Check for error messages

Common Issues & Solutions

Tracker Script

Script not loading

high

Symptoms:

  • No content injection
  • Console errors
  • Network failures

Solutions:

  1. Check if the script URL is accessible
  2. Verify your SITE_ID is correct
  3. Ensure the script is placed in the <head> section
  4. Check for ad blockers or security software

Content not injecting

medium

Symptoms:

  • Page loads normally
  • No FAQ sections
  • Original titles unchanged

Solutions:

  1. Verify your site ID in the dashboard
  2. Check browser console for JavaScript errors
  3. Ensure the page URL matches your sitemap
  4. Try enabling debug mode

SPA navigation issues

medium

Symptoms:

  • Content only loads on first page
  • Route changes don't trigger updates

Solutions:

  1. Ensure script loads before your SPA framework
  2. Check if your framework is detected correctly
  3. Verify history API is available
  4. Try manual refresh with window.LLMOptimizer.refresh()
Content Injection

Wrong content placement

medium

Symptoms:

  • Content appears in wrong location
  • Overlapping with existing content

Solutions:

  1. Add proper CSS selectors to your HTML
  2. Check for conflicting CSS styles
  3. Use custom placement options in dashboard
  4. Verify container elements exist

Content being overwritten

medium

Symptoms:

  • Injected content disappears
  • Original content restored

Solutions:

  1. Check for JavaScript that modifies DOM
  2. Look for CSS that hides injected elements
  3. Verify timing of content injection
  4. Check for framework-specific issues

Performance issues

low

Symptoms:

  • Slow page loading
  • High network usage

Solutions:

  1. Check network tab for failed requests
  2. Verify script is loading asynchronously
  3. Monitor Core Web Vitals
  4. Consider server-side rendering for critical content
Sitemap Import

Sitemap not accessible

high

Symptoms:

  • Import fails
  • 404 errors
  • Empty page list

Solutions:

  1. Verify sitemap URL is publicly accessible
  2. Check sitemap returns 200 status code
  3. Ensure proper XML format
  4. Try uploading sitemap file directly

Invalid XML format

high

Symptoms:

  • Parse errors
  • Missing pages
  • Import warnings

Solutions:

  1. Validate XML syntax
  2. Check for proper encoding (UTF-8)
  3. Verify required XML elements
  4. Use online XML validator

Missing pages

medium

Symptoms:

  • Not all pages imported
  • Some URLs skipped

Solutions:

  1. Check sitemap includes all important pages
  2. Verify lastmod dates are recent
  3. Ensure pages are accessible
  4. Check for robots.txt restrictions
Performance Optimization Tips

Optimize Script Loading

Ensure the tracker script loads efficiently

  • Use async and defer attributes
  • Place script in <head> section
  • Avoid blocking other resources
  • Consider preloading for critical pages

Minimize Content Size

Keep injected content concise and relevant

  • Focus on essential content only
  • Avoid duplicate information
  • Use structured data efficiently
  • Monitor content performance

Cache Optimization

Leverage caching for better performance

  • Enable browser caching
  • Use CDN for script delivery
  • Implement proper cache headers
  • Monitor cache hit rates

Still Need Help?

If you're still experiencing issues after following this guide, our support team is here to help.

Contact SupportBack to DocumentationHelp Center

Escalation Playbook

Use a repeatable playbook so troubleshooting stays fast and systematic.

●Capture request IDs, timestamps, and payload samples for each incident.
●Reproduce issues in staging before changing production settings.
●Classify failures by auth, data, integration, or rendering categories.
●Document final root cause and prevention action after each fix.

Execution Phases

Week 1: Foundation

Finish installation and validate data flow.

Output: Connected tracker, imported sitemap, baseline analysis report.

Week 2: Prioritization

Select high-impact pages and define task backlog.

Output: Prioritized optimization list with owners and due dates.

Week 3-4: Iteration

Ship updates and verify score + business impact.

Output: Before/after snapshots with measurable deltas.

Common Mistakes

●Starting automation before validating tracker and sitemap integrity.
●Treating overall score as the only KPI and ignoring category gaps.
●Rolling out broad template changes without controlled testing.
●Skipping documentation of changes, making results hard to attribute.

Success Metrics

Analyzed Coverage

>= 90% priority URLs analyzed monthly

Ensures optimization decisions are based on current data.

Score Movement

+8 to +15 points on target templates in 30-60 days

Validates that executed recommendations are improving quality.

Execution Velocity

At least 1 improvement cycle per week

Creates compounding gains from consistent iteration.

Cleversearch

Increase your website's visibility in ChatGPT, Claude, and Gemini responses. Optimize your content for LLM citation and discovery.

mansi@cleversearch.ai
+1 (604) 705-0740
New Westminster, BC

Product

  • Product Overview
  • Content Features
  • Content Writer
  • Auto Agent
  • Pricing

Resources

  • Blog
  • AI Tools
  • AI Scoring Tools

Comparisons

  • Cleversearch vs Profound
  • Cleversearch vs Search Atlas

Company

  • Services
  • About Us
  • Careers
  • Contact

Stay ahead of LLM optimization trends

Get weekly insights on LLM citation strategies, content optimization, and platform updates.

© 2024 Cleversearch. All rights reserved.

Privacy PolicyTerms of ServiceCookie Policy