> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hibonsai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common integration issues and fixes for Bonsai web components

## Bonsai Search SDK

<AccordionGroup>
  <Accordion title="The component renders but no results show">
    * Confirm `api-key` is present and valid.
    * Check `base-url` points to the correct environment.
    * Inspect the browser console for network or CORS errors.
  </Accordion>

  <Accordion title="Suggestions don't render">
    * Ensure `suggestions` is a valid JSON array string.
    * Use single quotes around the attribute and double quotes inside the array.
  </Accordion>

  <Accordion title="Styling changes don't apply">
    * Remember the component uses a closed shadow root.
    * Use CSS variables on `<bonsai-search>` or `::part(...)` hooks.
    * Verify your CSS is loaded after the component script.
  </Accordion>

  <Accordion title="Requests time out">
    * Increase `timeout-ms` for slower networks.
    * Check ad blockers or CSP rules that might block the API domain.
  </Accordion>
</AccordionGroup>

## Support

If you encounter any issues during integration or need assistance with customization, please contact your Customer Success Manager or reach out to our support team.