Skip to main content

Chat In Bubbles: Technical Considerations & Troubleshooting

In this article, you’ll find all the technical requirements and tips to ensure your bubble displays and functions correctly.

Updated over 2 weeks ago

⚠️ Important: Check this page if you're looking for the setup guide

Chat in Bubbles set-up guide


🔒 Website Security Settings (CSP)

Your website needs access to the domain *.storage.googleapis.com to load certain scripts and images (e.g. buttons or icons).

Required action: Ask your developers to update your CSP to include:

script-src: *.storage.googleapis.com img-src: *.storage.googleapis.com


🍪 Cookie Consent Settings

The bubble is only displayed when statistics cookies are accepted by the visitor.

Important note: If all cookies are blocked or rejected by the user, the bubble will not appear.
​


🏪 Custom Storefront

  • Create only one Custom Storefront even if you manage multiple stores

  • Use a single satellite snippet from it for all your stores

  • Add all store URLs in: Settings → Integrations → Custom Storefront → Advanced CORS Settings
    ​

  • 🎨 Advanced Targeting

    Page-specific targeting:

    • Use asterisk (*) for wildcards (e.g., hello-charles.com/*)

    • Add specific pages with Add new Page and enter the path

    • Note: You can include pages but cannot exclude specific pages from a wildcard


    📊 Priority Management

    When multiple bubbles target the same page, only the highest priority bubble will display.


    How ordering works:

    If you have multiple enabled bubbles on the same page, the system uses simple priority ordering:

    Example scenario:

    1. Bubble A: targets example.com

    2. Bubble B: targets example.com/products/

    3. Bubble C: targets example.com/products/fashion/

    If a user visits example.com/products/fashion/t-shirts, all 3 bubbles are valid, but only Bubble A (highest priority) will display.


    💡 Tip: Order your bubbles from most general to most specific for best results.



    🔧 Troubleshooting

    Bubble not appearing?

    Check these common issues:

    1. Cookie consent: Are statistics cookies accepted?

    2. CSP settings: Is *.storage.googleapis.com whitelisted?

    3. Page targeting: Does the current page match your targeting rules?

    4. Priority conflicts: Is another bubble taking priority?

    5. Custom storefront: Are all URLs included in CORS settings?

    Performance issues?

    • Reduce image file sizes

    • Simplify animations

    • Check network connectivity

    Styling problems?

    • Verify CSS conflicts with your theme

    • Test on different devices and browsers

    • Check z-index conflicts


​


​

Related Articles
Chat-in bubbles
Did this answer your question?