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:
new_page.body.example_inputURL 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 Option field with the name "job title" and values "Software Engineer", "Designer"; the page URL https://sample-tenant-1357.tines.com/pages/sample-guid?name=alice&job_title=Software%20Engineer when visited will populate the name field with the input "alice" and option field with the input "Software Engineer".
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.