Skip to Content
Troubleshooting

Troubleshooting

Common issues and solutions for Miniback widget integration.

Widget Not Appearing

Check Script Tag Placement

  • Verify the script tag is properly placed in your HTML
  • Ensure it’s before the closing </body> tag for best performance
  • Check that the script URL is accessible from your domain

Verify Project Configuration

  • Check that your project slug is correct and matches exactly
  • Ensure the project is active in your dashboard
  • Verify you’re using the correct script URL

Debug Console Errors

  • Open browser developer tools (F12)
  • Look for JavaScript errors in the console
  • Check the Network tab for failed script loads

Feedback Not Submitting

Domain Restrictions

  • Check domain restrictions in your project settings
  • Ensure your current domain is in the allowed domains list
  • Use wildcard patterns like *.yourdomain.com for subdomains

Project Status

  • Verify the project slug matches exactly (case-sensitive)
  • Ensure the project is active and not paused
  • Check that you haven’t exceeded your plan limits

Network Issues

  • Look for CORS issues in browser console
  • Check if your firewall or ad blocker is blocking requests
  • Verify the API endpoint is accessible

Performance Issues

Slow Loading

  • The widget loads asynchronously and won’t block page rendering
  • Widget size is under 55KB for fast loading
  • No external dependencies are required

Multiple Widgets Conflict

  • Ensure each widget has a unique project slug
  • Check that multiple widgets aren’t interfering with each other
  • Consider using a single widget with different configurations

Development vs Production

Local Development

  • Use localhost in allowed domains for testing
  • Enable development mode in project settings
  • Check that the script URL points to the correct environment

Production Deployment

  • Update script URL from localhost to your production domain
  • Configure allowed domains for security
  • Test thoroughly across all pages before going live

Browser Compatibility

Supported Browsers

  • Chrome 60+
  • Firefox 55+
  • Safari 12+
  • Edge 79+

Legacy Browser Issues

  • Check if your users are on unsupported browsers
  • Consider polyfills for older browsers if needed
  • Test widget functionality across different browsers

Common Error Messages

”Project not found”

  • Double-check your project slug spelling
  • Verify the project exists and is active
  • Check if the project was deleted or archived

”Domain not allowed”

  • Add your domain to the allowed domains list
  • Use wildcard patterns for subdomains
  • Enable development mode for localhost testing

📖 Domain Management Guide for detailed configuration

”Rate limit exceeded”

  • Check your submission rate limits in project settings
  • Consider increasing limits if needed
  • Implement client-side rate limiting if necessary

”Plan limit reached”

  • You’ve hit your plan’s monthly feedback or project limit
  • Upgrade your plan in Settings → Billing to increase limits
  • For project limits: pause unused projects to free up slots
  • For feedback limits: wait for next month or upgrade plan

📖 Billing & Plans Guide for upgrade options

Integration Issues

Slack Notifications Not Working

  • Check Webhook URL: Ensure the Slack webhook URL is correct and active
  • Test Connection: Use the “Test Connection” button in Settings → Notifications
  • Plan Requirements: Slack integration requires STARTER or PRO plan
  • Channel Permissions: Verify the Slack app has permission to post in your channel

📖 Slack Integration Guide for complete setup help

Email Notifications Missing

  • Check Spam Folder: Notification emails might be filtered as spam
  • Verify Email Settings: Confirm email addresses are correct in your settings
  • Plan Requirements: Email notifications require STARTER or PRO plan
  • Domain Reputation: Some email providers may block notifications initially

📖 Email Notifications Guide for configuration details

API Authentication Failures

  • API Key Format: Ensure you’re using the correct API key format (starts with mbk_)
  • Key Expiration: Check if your API key has expired in project settings
  • Header Format: Use x-api-key header, not authorization bearer token
  • Project Permissions: Verify the API key belongs to the correct project

📖 API Security Guide for best practices

Project Status Issues

Feedback Not Collecting (Paused Projects)

  • Project Status: Check if your project is paused in the dashboard
  • Plan Limits: Ensure you haven’t exceeded project limits for your plan
  • Domain Restrictions: Verify your website domain is in the allowed list
  • Widget Loading: Confirm the widget script is loading correctly

Project Creation Blocked

  • Plan Limits: Free plan allows 1 project, STARTER allows 10, PRO unlimited
  • Existing Projects: Pause or delete unused projects to free up slots
  • Billing Status: Ensure your subscription is active if on a paid plan
  • Account Verification: Complete email verification if using email signup

📖 Project Management Guide for managing projects

Getting Help

If you’re still experiencing issues:

  1. Check Status Page: Visit our status page for service outages
  2. Review Logs: Check your project’s activity logs in the dashboard
  3. Contact Support: Reach out with specific error messages and steps to reproduce
  4. Community Forum: Search or ask questions in our community forum
Last updated on
Examples