Tour targeting issues happen when selectors are unstable, the target loads late, the page route changes, or the selected element is inside a complex container. Use this checklist when a tour step points to the wrong place or does not appear.

Before you start

  • Open the tour in the builder and identify the affected step.
  • Know the URL and user state where the step should appear.

Steps

  1. Use Edit step in app to reselect the target element.
  2. Prefer stable CSS selectors, text, or event-based targeting over dynamic generated IDs.
  3. Confirm the step URL targeting matches the page where the target exists.
  4. Wait for the product UI to load before testing the step.
  5. Preview the tour from the beginning and from the affected step.
  6. Publish only after testing in the installed product environment.
  • Avoid targeting elements inside loading skeletons or temporary overlays.
  • Use a larger parent element when a small icon is difficult to target.
  • Use a modal step when precise targeting is not essential.

Troubleshooting

  • If the step never appears, check URL targeting and segment rules.
  • If the target moves after load, wait for the stable state or target a more reliable element.

Was this helpful?