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

How to Reset Scroll Position in a Microapp

This guide explains how to configure a tile to reset the scroll position of a microapp page or scroll container back to the top — useful for back-to-top buttons, navigation resets, and ensuring viewers always start a page from the beginning.

Overview

The Reset Scroll Position action is a click event you can add to a tile. When a viewer clicks the tile, it scrolls a target — the current page or a named scroll container — back to its starting position.

This is especially useful in microapps with long scrolling pages or multi-section scroll layouts where you want to control where a viewer starts when they navigate or return to a section.

Prerequisites

• Editor role or higher.

• A microapp open in the Builder.

• A tile to use as the scroll reset trigger. In Builder 2.0, this can be any tile type that supports click events, with the exception of Video tiles. In Builder 1.0, only Hotspot tiles support this action.

How to Configure Reset Scroll Position

1. Select the tile that will trigger the scroll reset on the canvas.

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 (resets the scroll of the page the tile lives on) or Named scroll container (resets a specific scroll container within the microapp).

5. Save your configuration.

6. Preview the microapp: scroll the target page or container down, click your configured tile, and confirm the scroll returns to the top.

Note: Reset Scroll Position cannot be combined with a Navigate to Page action on the same tile. When a viewer navigates between pages, whether the destination page keeps its previous scroll position depends on that page's scroll tile setting: Maintain Scroll Position ON keeps the last scroll position on return, while OFF resets the page to the top every time it's navigated to.

Common Use Cases

Use case

How to set it up

Back-to-top button

Place a tile at the bottom of a long scrolling page; configure it to reset the current page scroll.

Always-fresh section on arrival

Instead of combining actions on one tile, turn off Maintain Scroll Position on the destination page's scroll tile — it will open at the top whenever a viewer navigates to it.

Restart a scroll-state flow

Add a “Start Over” tile that resets a scroll container back to its initial state.

Chapter or section links

Set Maintain Scroll Position to OFF on the section's scroll tile so navigating there from a chapter menu always lands at the top of that section.

Common Questions

Does this work on all tile types?

In Builder 2.0, Reset Scroll Position is available as a click event on any tile type that supports click events, with the exception of Video tiles.

Can I reset a scroll container instead of a full page?

Yes — when configuring the action, select a named scroll container as the target instead of a page.

Can I combine this with other click event actions?

No — Reset Scroll Position cannot be combined with a Navigate to Page action on the same tile. If you want a destination page to always open at the top when a viewer navigates to it, turn off Maintain Scroll Position on that page's scroll tile instead.

Does this work in Builder 1.0?

Yes — Reset Scroll Position has been available since Builder 1.0, but only on Hotspot tiles. Builder 2.0 extends the same action to any clickable tile type except Video.