How to Use Next and Previous Subpage Navigation in Click Events

When configuring a click event in Builder 2.0, quick-select navigation options appear as pinned options at the top of the action dropdown. What you see depends on where the tile lives:

1. On a normal page, the dropdown pins Next Page and Previous Page.

2. On a subpage, the dropdown pins Next Subpage and Previous Subpage instead.

Instead of scrolling through a long list to find a specific page by name, you can wire forward and backward navigation in a single click. These actions resolve dynamically at runtime based on page order — so if you reorder your pages or subpages, the navigation updates automatically without needing to rewire your tiles.

Note: Next Subpage and Previous Subpage are only available when you're working on a tile that lives on a subpage. Normal (top-level) pages only offer Next Page and Previous Page. There is no quick-select for jumping from a normal page into a subpage set — to send a viewer from a page into a subpage, link directly to that specific subpage by name.

How to Add a Next or Previous Subpage Action

3. Select the tile you want to use as a navigation trigger on the canvas, on the subpage where it lives.

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

5. Click the action type dropdown.

6. Select Next Subpage or Previous Subpage from the pinned options at the top of the list.

7. Save your configuration.

Tip: Preview your microapp after wiring to confirm the navigation moves in the direction you expect, especially if your subpages have a non-linear order in the Pages panel. Also confirm what happens at the first and last subpage in the set — see the looping behavior below.

What Happens at the Start and End of a Subpage Set

Next Subpage and Previous Subpage loop within the subpage set rather than exiting it. If a viewer is on the last subpage and clicks a tile wired to Next Subpage, navigation cycles back around to the first subpage in that set — it does not continue on to the next top-level page. The same applies in reverse: Previous Subpage on the first subpage loops to the last subpage in the set.

Next / Previous Subpage vs. Named Page Links

Choosing between a dynamic quick-select and a named page link depends on your navigation pattern:

	Next / Previous Subpage	Named page link
Best for	Sequential, linear flows within a set of subpages	Jumping to a specific page regardless of position
Available on	Subpages only	Any page or subpage
Adapts to reordering	Yes — updates automatically	No — always links to the named page
At the last item	Loops back to the first subpage in the set	N/A — always goes to its fixed target
Ideal use case	Step-by-step stories, tutorials, guided flows within a subpage set	Menu navigation, entering a subpage set from a page, chapter jumps, fixed destinations

Common Questions

What happens if a viewer is on the last subpage and clicks a Next Subpage tile?

Navigation loops back to the first subpage in that set — it does not advance to the next top-level page. If you want a subpage flow to end by returning to the main page sequence, add a separate tile with a named link out of the subpage set rather than relying on Next Subpage.

How do I link from a normal page into a subpage?

There's no quick-select for this. Use a named page link and select the specific subpage you want to enter directly.

Will rewiring be needed if I reorder my subpages?

No — Next Subpage and Previous Subpage resolve dynamically at runtime based on current page order. Reordering subpages does not require you to update your click events.

Can I use Next / Previous Subpage on the same tile as another action?

Click event combinations depend on your Builder 2.0 configuration. Check the Click Event panel to see what action combinations are available for your tile type.

How to Use Next and Previous Subpage Navigation in Click Events

This guide explains how to use the Next Subpage and Previous Subpage quick-select options in the click event dropdown — the fastest way to wire sequential navigation within a set of subpages.