Static HTML Integration
Simple integration for static websites and landing pages.
Installation Steps
1. Basic HTML Integration
Add the widget script to your HTML pages before the closing </body> tag:
index.html
2. Verify Installation
After adding the code, reload your webpage. You should see the Suggesto feedback widget appear in the bottom-right corner (or where you have configured the widget to appear).
Static Site Generators
Jekyll Integration
For Jekyll sites, add to your default layout:
_layouts/default.html
Hugo Integration
For Hugo sites, add to your base template:
layouts/_default/baseof.html
Other Static Site Generators
For 11ty, Gatsby, or other static site generators:
Base Layout Template
CDN Integration
For better performance and reliability, use CDN delivery with fallback:
CDN Integration with Fallback
Event Handling
Listen to widget events for analytics tracking, custom integrations, or user experience enhancements:
Event Listeners and Custom Integration
Conditional Loading
Load the widget conditionally based on device type, user behavior, page context, or other JavaScript conditions:
Conditional Widget Loading
Troubleshooting
Check these common issues:
- Verify the board ID is correct
- Check browser console for JavaScript errors
- Ensure the script is placed before closing </body> tag
- Confirm the website is accessible via HTTPS
If your site uses CSP, add these directives:
Optimize widget loading:
- Use async or defer attributes on script tags
- Load the widget after page content has loaded
- Consider lazy loading for better performance
- Use the CDN version for faster delivery
Resolve script conflicts:
- Load Suggesto after other critical scripts
- Check for CSS z-index conflicts
- Ensure no other scripts are modifying the same DOM elements
- Use browser developer tools to debug conflicts
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx with your actual Board ID from the dashboard