Reset Scroll Position

1. Purpose & Scope

This article documents the Reset Scroll Position action, introduced in Tiled v59.0.0. This action allows content creators to configure a tile click event that returns the viewer's scroll position to the initial state of the microapp or a specific scroll container, ensuring consistent and predictable navigation experiences.

Scope: All Tiled users with Builder 2.0 access (Editor role and above). Relevant for microapps with scroll tiles, scroll states, or complex multi-page scroll layouts.

2. Control Objective

The control objective is to provide content creators with a reliable mechanism to reset scroll position as part of a viewer's navigation journey. Without this control, viewers navigating back to a previously scrolled page or scroll container would resume from their last scroll position, potentially presenting content out of sequence or skipping introductory content.

3. Feature Description

The Reset Scroll Position action is available as a click event option on any tile in Builder 2.0. When triggered, it scrolls the designated target — the current page, a specific page, or a named scroll container — back to its initial scroll offset (position zero). This action can be combined with page navigation or used as a standalone reset trigger.

Action Type	Click event — available on all tile types that support click events.
Target	Current page scroll, a named page, or a named scroll tile container.
Effect on Viewer	Scrolls the target to its initial position (offset zero) when the tile is clicked.
Combinable	Can be combined with navigate-to-page actions to reset scroll on arrival at a destination page.
Builder Version	Builder 2.0 only.

4. Configuring Reset Scroll Position

1. Select the tile that will trigger the scroll reset in Builder 2.0.

2. Open the Click Event panel in the Properties sidebar.

3. Select Reset Scroll Position from the action type dropdown.

4. Choose the target: current page, a specific page by name, or a named scroll container.

5. Save the configuration.

6. Preview the microapp: scroll the target down, then click the configured tile and verify the scroll returns to the top.

Note: This feature addresses a long-standing viewer experience gap where navigating back to a scrolled page placed the viewer mid-content. Combined with the Builder Reload action bug fix (TD-6497, KB-v59Apr26-06), scroll state is now reliably managed across navigation events.

5. Common Use Cases

Back-to-top button	A floating tile at the bottom of a long scrolling page — clicking it resets the page scroll to the top.
Navigation menu reset	A sidebar or nav tile that navigates to a new page and resets its scroll simultaneously.
Scroll state return	After a viewer has explored a scroll-state flow, a 'restart' tile resets to the initial scroll state.
Chapter/section navigation	Long-form content where each chapter link resets the destination to its beginning before the viewer reads it.

6. Change History

v1.0 — April 7, 2026

Initial article. Feature shipped in Tiled v59.0.0 (TD-6487).

Reset Scroll Position

New action to restore the initial scroll state of a microapp, improving navigation consistency for viewers