> ## Documentation Index > Fetch the complete documentation index at: https://docs.vaile.ai/llms.txt > Use this file to discover all available pages before exploring further. # Troubleshooting > Solve common issues with your Vaile chat widget ## Overview This guide helps you diagnose and resolve common issues with the Vaile chat widget. Follow these troubleshooting steps to get your widget working perfectly. ## Widget Not Appearing ### Initial Checks Check that the widget script is properly installed: ```html theme={null} ``` Ensure your widget key is correct: * No quotes around the key * Correct format: `wk_xxxxxxxxxxxxx` * No extra spaces Open Developer Tools (F12) and check for errors: * Red error messages * 404 (file not found) * Authentication errors In DevTools Network tab, verify: * Widget script loads (200 status) * No blocked requests * HTTPS connection ### Common Causes **Problem**: Script in wrong location **Solution**: Place script just before `` tag, not in `` ```html theme={null} ``` **Problem**: Other scripts causing conflicts **Solutions**: * Check console for JavaScript errors * Try on a test page with no other scripts * Ensure jQuery conflicts are resolved * Update conflicting libraries **Problem**: Browser extensions blocking widget **Solutions**: * Temporarily disable ad blockers * Whitelist your domain * Test in incognito mode * Check corporate firewall rules **Problem**: Styles hiding the widget **Solutions**: * Check for `display: none` on body * Look for high z-index elements * Inspect widget container element * Remove conflicting CSS ## Widget Appears But Doesn't Work ### Functionality Issues **Symptoms**: * Type message but can't send * Send button doesn't work * Messages disappear **Solutions**: 1. Check internet connection 2. Verify widget key permissions 3. Clear browser cache 4. Check for console errors 5. Test in different browser **Symptoms**: * Messages send but no reply * Typing indicator stuck * Generic error messages **Solutions**: 1. Check account status in dashboard 2. Verify API limits not exceeded 3. Test widget key in dashboard 4. Check service status page 5. Contact support if persistent **Symptoms**: * Unresponsive to clicks * Can't close widget * Animations stuck **Solutions**: 1. Refresh the page 2. Clear browser storage 3. Disable browser extensions 4. Check for memory issues 5. Update browser to latest ## Display Issues ### Visual Problems **Problem**: Widget in wrong spot **Fix**: Check for CSS conflicts ```css theme={null} /* Override positioning */ .vaile-widget-container { position: fixed !important; bottom: 20px !important; right: 20px !important; } ``` **Problem**: Messages truncated **Fix**: Viewport settings ```html theme={null} ``` ### Style Conflicts Common CSS conflicts and fixes: Issue Cause Solution Widget too small Global box-sizing Add widget-specific rules Wrong fonts Global font overrides Increase specificity Broken layout CSS framework conflicts Isolate widget styles Hidden elements Display properties Check computed styles

## Performance Issues ### Slow Loading Use DevTools Network tab: * Widget load time * File size * Connection speed Reduce overall page weight: * Compress images * Minify scripts * Enable caching * Use CDN Load widget after page: ```javascript theme={null} window.addEventListener('load', () => { setTimeout(() => { // Load widget script }, 2000); }); ``` ### High Memory Usage Signs and solutions: **Symptoms**: Page slows over time **Solutions**: * Update to latest widget version * Clear chat history periodically * Refresh page after long sessions * Check for console errors **Symptoms**: Fan noise, lag **Solutions**: * Disable animations * Reduce polling frequency * Close unused tabs * Update graphics drivers ## Mobile-Specific Issues ### Common Mobile Problems **Issue**: Widget doesn't adapt to mobile **Fixes**: * Add viewport meta tag * Check responsive breakpoints * Test orientation changes * Verify touch events work **Issue**: Keyboard covers chat **Fixes**: * Update widget version * Check viewport settings * Test different keyboards * Report device-specific issues **Issue**: X button not working **Fixes**: * Increase button size * Check touch target area * Remove conflicting handlers * Enable swipe-to-close ## Browser-Specific Issues ### Compatibility Problems Browser Common Issue Solution Safari Widget position fixed Add -webkit- prefixes Firefox Font rendering Specify font stack Edge Smooth scroll Polyfill if needed Chrome Extension conflicts Test in guest mode

## Integration Issues ### CMS-Specific Problems **Common Issues**: * Plugin conflicts * Theme overrides * Cache problems **Solutions**: * Use Code Snippets plugin * Clear all caches * Check theme footer.php * Disable plugins one by one **Common Issues**: * Checkout page conflicts * Theme updates removing code * App conflicts **Solutions**: * Use theme.liquid file * Create backup of changes * Test all page types * Check app compatibility **Common Issues**: * Editor preview differs * Mobile view problems * Custom code limits **Solutions**: * Publish to see changes * Use Wix dashboard * Check mobile editor * Upgrade plan if needed ## Error Messages ### Common Errors and Fixes Always check the browser console (F12) for specific error messages **Meaning**: Invalid widget key **Solutions**: * Verify key in dashboard * Check for typos * Regenerate if needed * Ensure account active **Meaning**: Script URL wrong **Solutions**: * Check script URL * Verify HTTPS * Clear DNS cache * Try direct URL access **Meaning**: Service issue **Solutions**: * Check status page * Wait and retry * Contact support * Check for updates **Meaning**: Cross-origin blocked **Solutions**: * Verify domain settings * Check HTTPS usage * Add to allowed domains * Contact support ## Debug Mode ### Enable Detailed Logging Add debug parameter to widget: ```html theme={null} ``` This provides: * Detailed console logs * Network request info * Error stack traces * Performance metrics Only use debug mode during troubleshooting, not in production ## Getting Help ### Before Contacting Support Try all relevant troubleshooting steps Check browser console for errors Test in incognito/private mode Try different browser Document error messages Note browser/device info ### Information to Provide When contacting support, include: 1. **Widget key** (first 8 characters) 2. **Website URL** where issue occurs 3. **Browser** and version 4. **Device** type (desktop/mobile) 5. **Error messages** (screenshots) 6. **Steps to reproduce** 7. **What you've tried** ### Support Channels [support@vaile.ai](mailto:support@vaile.ai) * 24-48 hour response * Detailed assistance * File attachments Live chat in dashboard * Business hours * Quick questions * Real-time help ## Preventive Measures ### Best Practices * Test after site updates * Check different browsers * Monitor error logs * Verify mobile experience * Widget auto-updates * Check for announcements * Review changelog * Test new features * Check load times * Watch error rates * Track engagement * Review analytics ## Quick Reference ### Troubleshooting Checklist Step Action ✓ 1 Check widget appears \[ ] 2 Verify console errors \[ ] 3 Test in incognito \[ ] 4 Check mobile view \[ ] 5 Clear cache \[ ] 6 Contact support \[ ]

## Next Steps Review installation steps Get personalized help