If a Chameleon Experience is appearing behind other page elements β or appearing on top of elements it should sit beneath β the cause is a CSS stacking order conflict. This article explains how to identify which element is causing the conflict and how to resolve it using custom CSS.
βΉοΈ This applies to Tours, Tooltips, Embeddables, Microsurveys, and Launchers. Available on all plans. Developer assistance may be needed for complex stacking contexts.
Availability & Usage
π Available for all plans
π§βπ» Developers can help
π Here for better Tours, Tooltips, Embeddables, Microsurveys, Launchers
βοΈ Adjust from the Builder
This property is useful in cases where several page elements may be overlapping each other, as this property sets the order of a positioned element and its descendants. Z-index adjusting works on elements that are positioned (e.g. absolute, relative, fixed) and flex items (children of flex elements)
With custom CSS you can leverage the z-index property along with the position property to set which page element should appear on top (or bottom) in your webpage. Here are the ranges you can use:
z-index: auto; (default value that sets the stack order equal to its parents)
z-index: 1; /2,3,4, etc. (negative numbers work too, sets the stack order of the element)
You can apply this in the Builder to your Launcher Widget, or Tour Trigger, for example, and control where each should display in relation to the other elements on your page.
Here's how you can use CSS rules and the z-index property to adjust where your Experiences display and make sure they don't overlap with other elements on your page. Conflicting CSS rules on your website can prevent desired positioning adjustments of Chameleon widgets. These occur when your site's custom code overrides Chameleon's default styling, causing alignment issues.
Use browser developer tools such as Chrome DevTools or Firefox Developer Tools to inspect the elements.
Look for specific CSS rules applied to the widget that might override positioning.
Add a custom CSS rule to target the element you want to adjust
Use the
Z-indexproperty to adjust its position
You can adjust the z-index relative to any anchored element if the Step or Launcher is positioned relative to an element.
If the conflict persists, inspect the element again β the effective z-index may be set by a parent element or a CSS stacking context rather than the element itself. In this case, ask your developer to help trace the stacking context.
π‘ Tip: Not sure where to start with z-index or custom CSS? Copilot can walk you through the steps and help you pinpoint what's causing the overlap.

