Actions at a Glance

navigate — Go to URL

Sends the user to any URL or path. Use this for external websites, special schemes like tel: or mailto:, and raw router paths. For navigating to another page in the same app by page ID, use navigateToPage instead.

Parameters

Warning: Path resolution rule: A value that starts with http://, https://, //, a special scheme, or a leading slash is used as-is. Anything else gets // prepended (so google.com becomes //google.com). An in-app path with a dot (like pricing.v2) will be treated as an external host — always prefix in-app paths with /.

Note: Chain gate: NO. The navigate handler returns an already-resolved promise and cannot fail the chain. Put navigate last in a chain when it targets the same tab — the runner continues executing remaining nodes even after navigation starts.

Examples

External URL in a new tab

{ "actionType": "navigate", "payload": { "path": "https://docs.unifyapps.com", "target": "_blank" } }

Same-tab navigation replacing history (e.g. after login)

{ "actionType": "navigate", "payload": { "path": "/dashboard", "history": "replace" } }

Dynamic path with preserved query params

{ "actionType": "navigate", "payload": { "path": "https://example.com/orders/{{ variables.orderId }}", "preserveSearchParams": true } }

Email link

{ "actionType": "navigate", "payload": { "path": "mailto:support@example.com?subject=Help" } }

navigateToPage — Go to Page

Navigates to another page in the same app by page ID. This is the correct action for in-app routing — it performs an SPA route change, preserves app state, and supports passing page parameters and inputs to the destination.

Parameters

Warning: Do not write openInNewTab. This is a form-only field in the builder that gets transformed to target before storage. Writing it in a stored payload is invalid. Always use target.

Examples

Simple same-tab navigation to a static page

{ "actionType": "navigateToPage", "payload": { "pageId": "e_68a881264ee5a774c912d4c1", "history": "push", "target": "_self" } }

Pass a dynamic path parameter to an order detail page

{ "actionType": "navigateToPage", "payload": { "pageId": "e_orderDetailPage", "pageParams": [ { "key": "id", "value": "{{ row.orderId }}" } ], "target": "_self" } }

Pass query-string inputs to a search results page

{ "actionType": "navigateToPage", "payload": { "pageId": "e_searchPage", "pageInputs": { "query": "{{ textInput_search['value'] }}", "category": "{{ select_category['value'] }}" } } }

Redirect-style navigation after login (no back history entry)

{ "actionType": "navigateToPage", "payload": { "pageId": "login", "history": "replace" } }

navigateBack — Navigate Back

Goes back in the browser or app navigation history — equivalent to the user pressing the browser Back button.

Parameters

Note: On mobile apps, navigateBack uses the native navigation stack — it is not just a history pop.

Examples

Simple back button

{ "actionType": "navigateBack", "payload": {} }

Back with fallback page (for deep-linked entry)

{ "actionType": "navigateBack", "payload": { "navigateToSpecificPage": true, "pageId": "e_homePage" } }

setURLParameters — Set URL Parameters

Updates the current page's query string without triggering a page navigation. The URL changes but the page stays mounted, making this ideal for filter state, active tabs, or any state you want reflected in the URL for sharing or back-button support.

Parameters

Update filter state in URL without navigating

{ "actionType": "setURLParameters", "payload": { "params": { "status": "{{ select_status['value'] }}", "page": "1" }, "history": "replace" } }

openShareDialog — Open Share Dialog

Opens the operating system's native share sheet (on mobile) or copies a link to the clipboard (on web). Use it on any "Share" button where you want users to forward a link to the current page or a specific record.

Parameters

Share current page with a custom title

{ "actionType": "openShareDialog", "payload": { "title": "Check out this order", "url": "{{ window.location.href }}" } }

Share a specific record URL

{ "actionType": "openShareDialog", "payload": { "title": "Order #{{ row.orderNumber }}", "url": "https://app.example.com/orders/{{ row.id }}", "text": "View the full details of this order." } }

Choosing the Right Navigation Action