Collecting input with forms

The most common way to use pages is to kick off a Story run based on some structured user input.

Defining input fields 

First, add a page and double click it to open the editor.

Then, use the page editor to select form input fields for the type of information you want to collect from the user. We support a variety of configurable inputs, from email address to file upload.

Each input field can be individually customized – e.g. to mark as required, set validation criteria like maximum length, or add a contextual description.

Connecting to your story 

Once your page is configured to accept the input you need, it's time to connect it to downstream actions (or other pages).

Just like actions, pages produce events once they're submitted, and these events get passed to everything downstream, providing contextual data.

For a simple example, let's say we've connected our page to an action that sends an email:

The "Send an email" action could then access the submitted page data using a formulas expression like the following:


URL query parameters 

In addition to accepting inputs from users, input fields can be populated using URL query parameters. If a page has a Short text field with the name "name" and an Email field with the name "email", the page URL when visited will populate the name field with the input "alice" and email field with the input "".

When providing values for fields, the slugified name of the field should be used as the query parameter name. Query parameters are supported for the input fields: Short Text, Long Text, Email, URL, Option, Date or time, Boolean and Number.
The Date or time query parameter accepts inputs using the ISO format. All other input fields accept text.

Was this helpful?