topic Conversations SDK : Handling Overlay Issues and Language Configuration Without Path Change in APIs & Integrations

Conversations SDK : Handling Overlay Issues and Language Configuration Without Path Change

FireHot — Fri, 23 Jan 2026 09:07:03 GMT

Hello HubSpot Developer Community,

I'm currently integrating the Conversations SDK into an H5 (mobile web) page and have encountered two challenges that I'd like to seek guidance on:

Overlay Blocking Issue with Buttons
When the Conversations chat bubble is displayed, the transparent portion of the iframe appears to block interactive elements (e.g., buttons) underneath it on the page. This behavior prevents users from clicking those buttons while the chat is open. Is there a recommended way to resolve this issue? For example:
- Can we adjust the z-index or CSS properties of the iframe or overlay?
- Are there any configuration options in the SDK to make the iframe non-blocking?
- Any known workarounds or best practices for handling this on mobile H5 pages?
Changing SDK Language Without URL Path Modification
Currently, our application's path does not support language parameters for loading the Conversations SDK. We need to set the language through JavaScript configuration rather than URL paths. Is there a way to dynamically set the language of the Conversations SDK without relying on the URL path? For instance:
- Can we pass a language parameter via JavaScript configuration?
- Does the SDK support setting locale through a config object or API call?

Any insights, code examples, or documentation references would be greatly appreciated!

Thank you in advance for your help.

Best regards.

Re: Conversations SDK : Handling Overlay Issues and Language Configuration Without Path Change

BérangèreL — Fri, 23 Jan 2026 11:35:23 GMT

Hi @FireHot and a big warm welcome from the HubSpot Community! 🧡

Thanks for posting here! For reference, here are some documentations:

- Conversations SDK
- Visitor Identification

Now, I'd love to put you in touch with our Top Experts: Hi @suprdense, @Anton and @d-lupo do you have suggestions for @FireHot, please?

Thanks so much and wishing you a great weekend!
Bérangère

Re: Conversations SDK : Handling Overlay Issues and Language Configuration Without Path Change

FireHot — Sat, 24 Jan 2026 06:47:22 GMT

Thank you @BérangèreL for sharing those documents. I've already reviewed them, but unfortunately they don't address the specific issues I'm facing with the H5 chat bubble implementation - particularly the overlay blocking issue with underlying buttons and how to programmatically set the SDK language without URL parameters.

The documentation covers general API usage but doesn't seem to have details about these mobile-specific challenges. Would appreciate if anyone has direct experience with these particular issues in H5 environments.

Looking forward to hearing from the experts!

Re: Conversations SDK : Handling Overlay Issues and Language Configuration Without Path Change

BérangèreL — Tue, 27 Jan 2026 09:41:57 GMT

Hi @FireHot and thanks for getting back to us!

Regarding the overlay blocking issue, while the documentation doesn't currently offer specific guidance on adjusting the iframe's z-index or making it non-blocking, this seems to be a known limitation with the chat widget's iframe setup. Here are some helpful tips that may work for you:

- Try using CSS to fine-tune the z-index values of your page elements relative to the widget.
- You might also consider using the inlineEmbedSelector option in hsConversationsSettings to embed the widget within a designated container on your page, rather than as an overlay.

As for the language configuration via JavaScript, at the moment, the Conversations SDK documentation doesn't indicate a JavaScript setting for customizing the widget's language or locale.

The hsConversationsSettings object provides useful options like loadImmediately, inlineEmbedSelector, enableWidgetCookieBanner, and disableAttachment, but there isn’t a documented language or locale parameter just yet.

Typically, the widget’s language is set based on your HubSpot account preferences, or it's detected automatically via the browser or URL instead of through SDK configuration.

Let's connect you with our Top Experts: Hi @evaldas, @MichaelMa and @Tmedflex can you think of workarounds to help @FireHot, please?

Thanks so much and have a brilliant day!
Bérangère

This post was created with the assistance of AI tools