Themeisle Docs

Appearance

Troubleshooting Hyve answer quality and widget position ​

If Hyve gives incomplete replies or if the chat bubble appears in the wrong place on your site, use this guide to diagnose and fix the most common causes.

Hyve gives incomplete answers ​

Incomplete answers usually happen when your Knowledge Base is not fully processed, embeddings fail, or the selected model is too limited.

1. Confirm your Knowledge Base finished processing ​

When you add new posts or pages, Hyve needs time to process them into embeddings. This is handled by WordPress cron tasks, which typically run about once per hour.

  1. In your WordPress dashboard, open Hyve > Knowledge Base.
  2. Check whether your recently added content is still pending or listed in Requires Update.
  3. Wait for the next cron cycle, then test the same question again.

📝 Info: If your site has low traffic, WP-Cron may run less frequently, which can delay Knowledge Base updates.

2. Check your OpenAI API key and available credit ​

If OpenAI requests fail, Hyve cannot generate embeddings or reliable responses.

  1. Open Hyve > Settings > Advanced.
  2. Confirm that OpenAI API Key is set correctly.
  3. Verify in your OpenAI account that API usage is enabled and credit is available.
  4. Return to Hyve > Dashboard and review any visible error notices.

3. Use a more capable assistant model ​

Entry-level models can return weaker or shorter responses for complex questions.

  1. Open Hyve > Settings > Assistant.
  2. In Model, select a more capable option (for example, GPT-4.1 or GPT-4o).
  3. Save changes and test the same question again to compare answer quality.

💡 Tip: Keep your Temperature and Top P defaults while troubleshooting. Change only one variable at a time so you can clearly see what improves results.

Move the chat widget to a different position ​

Hyve’s floating chat bubble uses a fixed default position from plugin CSS. If it overlaps your cookie banner, floating buttons, or other UI elements, reposition it with custom CSS.

  1. In WordPress, go to Appearance > Customize > Additional CSS (or your theme’s custom CSS area).
  2. Add CSS similar to this and adjust the values:
css
.your-hyve-bubble-selector {
  right: 20px;
  bottom: 100px;
}

Replace .your-hyve-bubble-selector with the selector used by your Hyve chat bubble on your site.

  1. Publish your CSS changes.
  2. Reload your site and confirm the bubble no longer overlaps other elements.

⚠️ Warning: If you use a caching plugin or CDN, purge cache after changing CSS so the new widget position appears for visitors.