Intercom tooltip not showing when updating custom attribute via Intercom('update') | Community
Skip to main content
Answered

Intercom tooltip not showing when updating custom attribute via Intercom('update')

  • January 20, 2026
  • 1 reply
  • 168 views
M

I’m working with Intercom tooltips and want to show or hide them conditionally from my web UI.

I have a toggle button in my frontend that allows users to manually turn tooltips on or off. Based on this toggle, I want to control the visibility of Intercom tooltips.

What I’ve done so far:

  • In Intercom, I configured the tooltip rule as:

    learn_mode == true

  • On the frontend, when the toggle button is clicked, I call:

    Intercom('update', { learn_mode: true }); // or false

  • The goal is:

    • learn_mode = true → show tooltips

    • learn_mode = false → hide tooltips

Issue:

The Intercom('update') call does not seem to trigger the tooltip. The tooltip does not appear or disappear as expected when toggling the button.

Question:

What could be the possible reasons why the Intercom('update') call is not triggering the tooltip, and what should I check to ensure the tooltip renders correctly based on the custom attribute?

Best answer by Sean Meade Forum Support Lead

Hi ​@moeznazir47, Seán here from the Intercom engineering support team 👋 thanks for reaching out on this.

The tooltips are loaded on page load along with your sites HTML and CSS files so the page would need to refresh. The tooltip uses HTML attributes to place them so the decision on whether the User can see them or not are done as the page is loaded and either placed on the page or not.

You could use one of the following after the update to do it:

// Reload using the browser cache (default)
location.reload();

// Force a hard reload (re-fetch from server)
location.reload(true);

1 reply

S
Intercom Team
Forum|alt.badge.img+5

Hi ​@moeznazir47, Seán here from the Intercom engineering support team 👋 thanks for reaching out on this.

The tooltips are loaded on page load along with your sites HTML and CSS files so the page would need to refresh. The tooltip uses HTML attributes to place them so the decision on whether the User can see them or not are done as the page is loaded and either placed on the page or not.

You could use one of the following after the update to do it:

// Reload using the browser cache (default)
location.reload();

// Force a hard reload (re-fetch from server)
location.reload(true);

Terms & ConditionsAccessibility statement