Create a form to enable users to add items to a list, along with list properties and line item values.

Lists, list properties, and line items are configured in the source model of a page.

Parent items

Lists can be organized into list hierarchies to enable data from child items to roll up to a parent item. For example, a city is a child of a country, and a country is a child of a region.

As a page builder, you can select a parent item for all list items added via a form. Alternatively, you can enable users to select a parent item for each list item added via a form.

If the list is part of a composite list, you can only select a parent item if the list the form belongs to is in the parent list. For example, a composite list might combine a Cities list and a Countries list. You can't select a city to be the parent of another city. You must select a parent from the Countries list.

To edit cards, select Edit to open your page in designer mode.  

Select Save to save as a draft, or Publish to publish the page. 

Note: Selective Access can restrict access to lists and list items on a user-by-user basis.

To create a form:

  1. To add or edit a card, select Configure action on a new card, or hover over your card and select Edit .
  2. On the Overview tab of the Card configuration panel, enter a Title and Description for your card. You can also choose a Title color, Link to a page, and display the card Background.
  3. On the  tab, select Create > Form to open the Form designer. 
  4. Enter a Form title and select a list from the Choose list dropdown. 
  5. If the list has one or more list subsets, you can select a subset from the Subset dropdown.
    This configures the form to add items to the selected subset.
    If no subset is selected, the form adds items to the list selected in the Choose list dropdown menu.
  6. Under the Properties heading, enable any properties you want users to be able to add to the form.
    To configure which characters users may enter for a property, or make a property mandatory, hover your cursor over a text-formatted list item in the form preview and select the cog icon in the top-right.
    You can enable read-only list properties, for example, those that contain formulas, in the Form designer, but they won't display in the form.
  7. Toggle Allow user to choose a parent to decide if users can assign a parent to list items.
    1. If enabled, enter a Parent label and select a module from the Choose module dropdown. 
    2. If disabled, you can select a Parent from the dropdown and select a module from the Choose module dropdown. 
  8. To configure individual fields, select the cog icon in the preview. You can:
    1. Toggle Validation rules. For example, Field is required or Allow numbers. 
    2. If you enable Allow special characters, select All special characters or Just hyphens '-' and underscores '_'.
    3. If you enable Specify field length, you can enter a Minimum and/or Maximum value.
  9. Select Create.

Configure the context selectors

Optionally, if you have enabled the submission of values for line items, configure the context selectors in the top-right of the Form designer.

  1. Select a value from the context selector to determine the default location where a form submits line item values in the module.
  2. Select the cog icon on the left of a context selector to show further options you can configure. Select Apply to save any changes made:
    • Copy from page.
      Enable this to make the form open with the same values on context selectors as the page it's opened from.
    • Show on page.
      Select Off to not show the context selector on the form, Label to display the context selector as a label, or Selector to display the context selector.
    • Levels to show.
      Select the checkboxes under this to determine which levels of a list hierarchy display on the context selector.