Skip to content
English
Submit a request
  • There are no suggestions because the search field is empty.

Builder 2.0: Reset Scroll Position on Click Events

Tiles with click events now support a reset scroll position option for improved viewer navigation control

1. Purpose & Scope

This article documents the Reset Scroll Position option for tiles with click events, introduced in Builder 2.0 as part of the Tiled v59.0.0 April release. This option gives content creators explicit control over whether the viewer's scroll position is reset when a click event navigates to a new page, overlay, or scroll state.

Scope: All Tiled users with Builder 2.0 access (Editor role and above) who use click events on tiles.

2. Feature Description

When a tile has a click event configured (e.g., navigate to page, open overlay, trigger scroll state), Builder 2.0 now exposes a Reset Scroll Position toggle in the click event configuration panel. When enabled, navigating via the click event will scroll the destination page or state back to its top position, ensuring the viewer always starts from the beginning of the destination content.

Reset Scroll: On

When the click event fires, the destination page or scroll state resets to the top (scroll position 0). The viewer always sees the beginning of the destination content.

Reset Scroll: Off (Default)

The destination page or scroll state retains its previous scroll position. The viewer resumes from where they last left the destination.

3. Configuring Reset Scroll Position

  1.     Select the tile in Builder 2.0 that has a click event configured.
  2.     In the Properties panel, locate the Click Event section.
  3.     Expand the click event configuration to reveal the Reset Scroll Position toggle.
  4.     Enable or disable the toggle according to the intended viewer behavior.
  5.     Preview the microapp to confirm the scroll behavior matches the intended experience.

Note: Reset Scroll Position applies to the destination of the click event. For page navigations, the destination page scroll resets. For scroll states, the scroll state position resets. This setting does not affect the source tile's scroll position.

4. When to Use Reset Scroll Position

Enable Reset Scroll Position when:

  •   The destination page contains a long scroll and the viewer should always start from the top when navigating to it.
  •   The microapp is structured as a linear narrative where each click advances to a fresh starting point.
  •   UX testing or stakeholder feedback indicates viewers are confused by landing mid-scroll on a destination page.

Leave Reset Scroll Position off when:

  •   Viewers should be able to return to a partially-scrolled page and resume where they left off.
  •   The destination page has a persistent scroll state that is intentionally remembered across navigations.

5. Change History

v1.0 — April 2025

Initial article. Feature shipped in Tiled v59.0.0 April release.