Skip to main content

Troubleshooting

Solutions to common widget issues.

Widget doesn't load​

Verify the token​

// In browser console
console.log('Configured token:', document.querySelector('[data-token]')?.dataset.token);

If the token is empty or incorrect, get a new one from the Dashboard.

Check console errors​

Open DevTools (F12) → Console and look for errors:

  • 401 Unauthorized: Invalid or expired token
  • 403 Forbidden: Unauthorized domain
  • 429 Too Many Requests: Rate limit reached
  • Network Error: Connection problem

Verify CORS​

If you see CORS errors, make sure your domain is verified in the Dashboard.

Styles not applied​

Verify CSS is loaded​

<!-- Must be in <head> -->
<link rel="stylesheet" href="https://cdn.neuroon.ai/widget.css">

Conflicts with existing CSS​

If your CSS interferes with the widget:

/* Increase specificity */
#neuroon-search .neuroon-widget {
  /* your styles */
}

Or use !important as a last resort.

Voice search doesn't work​

Requirements​

  • HTTPS (required)
  • Compatible browser: Chrome, Safari, Edge
  • Microphone permission granted

Verify support​

const supported = 'webkitSpeechRecognition' in window || 'SpeechRecognition' in window;
console.log('Voice supported:', supported);

Products don't appear​

Verify synchronization​

  1. Go to Dashboard → Products
  2. Verify there are indexed products
  3. Check that products are active (not drafts)

Verify filters​

Filters may hide results:

// Clear filters
widget.clearFilters();
widget.search('test');

Slow performance​

Reduce results per page​

NeuroonWidget.init({
  ui: {
    resultsPerPage: 10, // Default: 20
  },
});

Lazy loading images​

The widget uses lazy loading by default. If you see issues:

.neuroon-product-image {
  loading: lazy;
}

Rate limiting errors​

If you receive 429 errors:

  1. Wait: Limits reset every minute
  2. Reduce searches: More aggressive debounce
  3. Contact support: If you need more capacity

Debug mode​

Enable detailed logs:

NeuroonWidget.init({
  debug: true, // Logs in console
});

Contact Support​

If the problem persists:

  1. Capture the console error
  2. Note your Shop ID
  3. Describe the steps to reproduce
  4. Contact us at support@neuroon.ai