Layer Order (Z-Index)

Last Updated May 20, 2026

Brief Overview

Z-index controls the stack order of an element relative to other elements on the same page. An element with a higher z-index appears in front of one with a lower z-index.

You may need to adjust the z-index when a WalkMe item is overlapping a site element your users need to access, or when a site element is covering a WalkMe item.

Z-index is available for Smart Walk-Thrus, SmartTips, and launchers.

Changing the Layer Order

  1. Open your item 
  2. Go to the Behavior tab and turn on Arrange layers (z-index)
  3. Select Edit on Page below the z-index setting or in the upper right corner of the screen

    Note

    The button will be disabled if the element your item is attached to is not present on your current open page.

  4. Choose one of the following:
    • Bring forward — if your WalkMe item is hidden behind a site element
    • Send backward — if your WalkMe item is blocking a site element
  5. Select Select on-screen Element
  6. Select the on-screen element that's interfering with your item — the z-index value in the Define z-index value manually section will update automatically

Setting Z-Index Manually

You can also set the z-index value directly:

  • In the Edit on Page screen, enter a value under Define z-index value manually
  • In the Behavior tab, enter a value under Set z-index manually

Z-index accepts positive, negative, or zero values. Elements are layered in numerical order — higher numbers appear on top. When no z-index is set, elements default to 0.

Dynamic Z-Index

For systems created on or after Nov 24, 2025, a Dynamic z-index option is available. When turned on, WalkMe automatically calculates the best z-index for each user based on the page they're on.

Enabled feature


For systems created before November 24, 2025 please request access from your Customer Success Manager or WalkMe contact.

Technical Notes

  • Depending on your site's structure, changing the z-index may not always have the expected effect — use the Lock to Element setting alongside z-index in those cases
  • Salesforce Lightning doesn't support Arrange Layer Order (z-index) — adjust the z-index value manually or use Lock to Element instead

Was this article helpful?

Thanks for your feedback!

Be part of something bigger.

Engage with peers, ask questions, share ideas

Ask the Community
×