Build a form with Rewst's Form Builder

Learn how to build and customize your Rewst Forms

Create a new form

The part of Rewst you use to create and edit forms is called the Form Builder. To access it, navigate to Automations > Forms, and click .

In the Create New Form dialog, give your form a descriptive name. Remember, as you build more in Rewst, your list of forms will grow significantly. Following proper naming conventions will save you time in finding your right form later on.

The Form Builder is similar to Rewst's Workflow Builder in that it has a list of options on the left, called form fields, which can be dragged and dropped onto the canvas in the center of your screen.

Each of these options will relate to your inputs, or the information that goes into the form. With the exception of the Text/Markdown field which is only used for presenting data to the end user, all other fields are used as data input and contain a field name, field label and field description. The field name is the variable name used within the workflow once the form has been submitted. The field label and field description are used to format the appearance of the form.

Using the correct fields ensures your workflows receive clean, organized data.

Form field options

Click on any of the below form field options to expand and see its information.

Text/Markdown

The Text/Markdown field lets you present text, optionally formatted with Markdown. You can also render Jinja in these fields, which can be useful for presenting organization variables, or rendering a Markdown table with data from elsewhere in the form.

Drop-down

Drop-down fields let you select from multiple options, which can either be hard coded into the form or dynamically generated. Each option on the form has a label and a value, and default options can be preselected if specified. There are also options for:

• Auto-Populate: if enabled, will always pre-populate the field if only a single option has been returned.

• Allow Custom Input: lets the enduser write in the field and have that be the value passed into the workflow.

• Always Skip Cache: causes the option generator to always run instead of pulling from a cache. Note that the cache for a form field invalidates every 8 hours. Typically the first run of the day will be slower than the rest.

• Always Override Option: used when the auto-populate setting is enabled, this will cause the field to repopulate itself. This is needed in cases where the field is populated via an option generator and another field is being used as input for the option generator. In that case, you would need the option generator to run again, as the output would likely be different.

These are used most commonly when the list of options is being generated via an options generator . Drop-down selection is limited to a single option. For multiple options for selection, see the multi-select form field option.

Multi-Select

Multi-select is similar to the dropdown field, but lets you select as many options as you like, up to a maximum number of options which can be specified on the field.

Here are two examples, one for returning a specific item within the list, and one for checking if values are provided:

{{ CTX.<field_name>[0].value|d }}

{{ CTX.<field_name>|length > 0 }}

Checkbox

The Checkbox field provides a toggle with a true/false value for the form. You can also change the label positioning.

Radio Buttons

The Radio Buttons field offers a selectable single option. It can also be dynamically populated in the same way as a dropdown or multi-select field, but doesn't allow for the additional options of auto-populate, allow custom input, always skip cache and always override option. For this reason, radio buttons are rarely used with dynamic options.

Text Input

The Text Input field accepts a single line text string. You can also perform regex validation and error reporting, or populate the field with a default value.

Number Input

The Number Input field accepts numbers, as long as they meet the Python definition of numbers: whole numbers or floats. Set a default value, as well as minimum and maximum values.

Multi-Line Input

The Multi-Line Input field accepts large amounts of text. No validation is available for this field.

Date

The Date field can be set up to accept dates, or times and date times together.

Note that the time zone or this field is based on your browser locale. Rewst converts the time into UTC when passed into the workflow without the time zone data. As an example, if you're in EST and you select 6pm, the workflow will receive this as 1pm UTC, due to the 5 hour offset. Adjust your submission for this time difference when you are submitting a form for a customer in a different time zone from yourself, and need to specify a time.

File Upload

The File Upload field allows for the uploading of specific file types:

.CSV .JSON If you are working with an XL or XLSX file format, convert it to CSV before uploading.

Dynamic options in forms

Dynamic options automatically fetch data from integrations, thereby eliminating the need for manual data entry and keeping form options up-to-date with the latest data. For example, if you're managing hiring information within your PSA, dynamic options can automatically pull this data into the form, ensuring that users always have the most current information.

There are two types of dynamic options: integration reference and workflow generated.

Option one: Integration reference

A reference option is a dynamic field pulled directly from predefined actions. It works well for straightforward data retrieval, but may require conversion to a workflow-generated option for data manipulation, as this doesn't give any filtering options and will pull directly from the API endpoint.

Integration reference example

Selecting the Microsoft Graph integration to list all users.

Pulling data straight from the integration like this only works at the top, parent level organization where the integrations are installed. This option won't work for dynamically pulling child organization data. To achieve this, you would require an options generator.

Option two: Workflow generated options

If you want more flexibility around the output of the data your user is seeing, you may need to opt for a workflow generated option instead, which allows for in-depth data manipulation using Jinja. We cover what these are and how to use them in Cluck U’s Rewst Foundations and micro course. If you’ve already taken our courses and want a refresher, see our documentation on option generators here and here.

Alternatively, dynamic forms use cases can be handled with our options filter feature. The options filter makes customizing drop-down fields within forms straightforward for those who want to add filtering without updating an options generator workflow. It takes inputs, filters them, and produces an output agnostic of the data source. See our separate options filter documentation here.

This setup requires the workflow type be an option generator. See our option generator workflow page for more details on this functionality. The below documentation is high-level only.

Options generator example

In this image, what is shown to the user is what is set as the label for the list contents. Ultimately, it can be whatever you want it to be, using Jinja to manipulate that output correctly. The ID is the value or unique ID of what the workflow is referencing for its future actions.

Set default options

Default options can be selected for a form field linked to a workflow by following these steps.

1. Add a boolean property to each option result.

2. Define the boolean property for the Default Selected Field value.

Sample data returned by a workflow:

[
    {"label": "Adam", "id": "1", "current_default": false},
    {"label": "Matt", "id": "2", "current_default": false},
    {"label": "Jareth", "id": "3", "current_default": true}
]

Fields to be filled out in the form:

• Value Field: id

• Label Field: label

• Default Selected Field: current_default

Dynamic form links

A dynamic form link is a special type of URL that automatically directs users to the form specific to the organization they belong to in Rewst. Rather than using a static form link that always goes to the same location, a dynamic form link adapts depending on who is accessing it.

When sharing a form, instead of clicking View Direct URLs, you can click Copy URL. This generates a dynamic link that looks like this:

https://app.rewst.io/form/<form_trigger_guid>

When a user opens this link:

1. The system checks who is logging in.

2. It validates which organization the user belongs to.

3. The user is then automatically redirected to the correct form URL for their organization.

This ensures that users always land on the right form instance without needing to know or select their organization manually. Use a dynamic form link whenever you have a form that multiple organizations or users need to access, or when you want to provide a single, easy-to-share URL rather than multiple specific links.

Dates in forms

Form date formats — DD/MM/YYYY) versus MM/DD/YYYY— are influenced by browser locale settings, not controlled by the application itself. IT admins could deploy the desired locale to all of their customers if they want to ensure consistent appearance. Setting it once in the browser will set it for all forms.

Set your browser's locale

Your browser’s locale controls:

• How dates and times appear

• The language used in websites and spellcheck

• The region format for numbers and currency

Follow the steps below for your relevant browser to use only the region you need, and remove the others for consistent behavior.

Mozilla Firefox

Open Language Preferences

1. Navigate to Settings > General > Language.

2. Under Language and Appearance, click Choose… next to Language for displaying pages.

3. Add only your desired language region:

   • English (Australia)

   • English (United States)

   • English (United Kingdom)

Remove Others

• Highlight any extra languages and click Remove so only one remains.

Confirm Locale

(Optional advanced step)

1. In the address bar, type about:config.

2. Search for: intl.locale.requested

3. Set it to:

   • en-AU for Australia

   • en-US for United States

   • en-GB for United Kingdom

4. Restart Firefox.

Google Chrome

Open language settings

1. In the address bar, go to:

   chrome://settings/languages

2. Under Languages, click Add languages.

3. Search for and add only one of the following, depending on your region:

   • English (Australia) → en-AU

   • English (United States) → en-US

   • English (United Kingdom) → en-GB

Remove unused languages

• Click the ⋯ next to any other languages and select Remove. This prevents Chrome from using fallback locales.

Set as display language

• Click the ⋯ next to your chosen language.

• Select Display Google Chrome in this language.

• Restart Chrome to apply the change.

Check your date/time format

• Open your system settings to make sure the region matches your browser locale:

  • Windows: Settings > Time & language > Language & region

  • macOS: System Settings > General > Language & Region

Microsoft Edge

Open Language Settings

1. Navigate to:

   edge://settings/languages

2. Click Add languages and add only one:

   • English (Australia)

   • English (United States)

   • English (United Kingdom)

Remove Extra Languages

• Click the ⋯ beside any other languages and choose Remove.

3. Set Display Language

• Click the ⋯ next to your chosen language.

• Select Display Microsoft Edge in this language and restart Edge.

4. Match Your System Region

• Go to Settings > Time & language > Language & region > Regional format

• Choose the same region: Australia, United States, or United Kingdom.

Then, confirm your browser's locale:

1. Open the browser console by pressing F12, then navigating to Console.

2. Run:

   console.log(navigator.language);
   console.log(new Date().toLocaleString());

3. Expected outputs are as follows.

Region	navigator.language	Date rxample	Format
Australia	"en-AU"	09/10/2025, 13:30:00	DD/MM/YYYY
United States	"en-US"	10/9/2025, 1:30:00 PM	MM/DD/YYYY
United Kingdom	"en-GB"	09/10/2025, 13:30:00	DD/MM/YYYY, 24-hour clock

Workflow inputs

Workflow inputs in Rewst offer a flexible way to define specific inputs to a workflow via a form. This functionality allows you to handle various client cases and attributes dynamically. By understanding these concepts and utilizing the provided examples, you can create versatile and dynamic forms tailored to your specific needs.

Below are some key aspects of workflow inputs:

Use org variables for client-specific workflows

If you have a form used across multiple clients, each with distinct environments like Microsoft 365 or On-Prem, you can use an org variable to dictate the source of the data.

For example, by employing {{ ORG.VARIABLES.primary_identity_provider }}, which is set per client as either on_prem or azure_ad, you can use the same form for both client cases. The form will be pulled from the relevant system.

Hard-code attributes for efficiency

Instead of creating separate workflows for various attributes such as department, userPrincipalName, or ID, you can use a single workflow with a hard-coded element. This approach takes your input and returns the desired property.

For example, the attribute department can be hard-coded to allow a single workflow to handle different returned properties.

Here's a Jinja code snippet for achieving this:

{%- set attribute_collection = [] -%} 
{%- set my_attribute = CTX.attribute -%} 
{%- set my_data = CTX.data|selectattr(my_attribute) -%} 
{%- for user in my_data -%}
    {%- if user[my_attribute] or false -%}
        {%- set value=user[my_attribute] -%}         
        {%- set tmp = attribute_collection.append({my_attribute:value}) -%}     
    {%- endif -%} 
{%- endfor -%} 
{{- attribute_collection | unique(attribute=my_attribute) | sort(attribute=my_attribute)  -}}

Test a form: How to get a form's URL

Recall that you can access all forms in your form list in Rewst. Understanding how to test a form can sometimes be confusing due to its intrinsic link to a workflow. To get the Form URL for testing directly from a workflow:

1. Locate the trigger on the workflow.

2. Click View Form URLs.

3. Select the desired organization's form from the list.

Restrict form drop-downs

The onboarding form includes a number of fields to be filled out when onboarding new users. The default behavior of all the drop-down fields is to pull the list of options from the API. This is because the drop-down fields have Dynamic Options toggled on.

While this may work in many cases, there are scenarios where it makes sense to limit the number of options based on the customer segment you're working with. An example of this might be that you need to limit which email domains each customer sees. You may also want to limit which locations customers can choose from. In any case, you can set specific values for the default_form organization variables to use in your forms.

The example below is specifically for the User Onboarding Form and workflow, as it is currently the most likely use case.

Add an organization variable to a form

You can add default values for any of the form organization variables below:

To view the form org variables table, click here.

Limit the email domains in the user onboarding form

Add the organization variable to an organization

1. Navigate to Configuration > Organization Variables.

2. Click Add at the top right.

3. Enter in the following for the new organization variable:

   • Name: form_default_email_domain

   • Value: ["email domain"]

   • Category: General

   • Organization: Choose Your Organization

Any value you add to a variable must exist in the list that the form value is pulling from. An example of this would be that any email domain added as a default must exist in the list that is pulled from the Microsoft API.

Next, the variable can be added to the form field.

Add the organization variable to the form field

1. Navigate to Automations > Forms.

2. Open the User Onboarding Form.

3. Click to open the settings for the Email Domain Name field.

4. Enter true in the schema.enumSourceWorkflow.input.force_default setting.

5. Enter email_domain in the schema.enumSourceWorkflow.input.choose_variable setting.

You only need to add the latter half of the form_default variable when adding it to the schema.enumSourceWorkflow.input.choose_variable setting.

1. Click Save.

Make sure to set the org variable values for any company organization using the form. For example, say there are three company organizations that need to use the same form with a list of three domains to choose from. Each organization needs to have the variable added with the domain values set. If you only set the variable and values in Company 1, the other two Companies won't see any options to choose from.