Skip to content

Row ​

The Row element is a layout container that displays multiple fields side by side in columns. You can set the number of columns, customize the width of each column, and control responsive breakpoints.

Basic ​

Number of columns ​

The number of columns in the row. Available options:

  • 1, 2 (default), 3, 4, 5, 6, 7, 8, 10 columns

TIP

After adding a Row element and setting the number of columns, drag other elements into each column to create a side-by-side layout. For example, with 2 columns, you can display "First Name" and "Last Name" fields side by side.

Customize column widths (%) ​

The width percentage of each column. Each column corresponds to an input box; enter a number to set that column's percentage of the total width.

Column width allocation

  • By default, columns are equally distributed (e.g., 2 columns at 50% each)
  • You can customize unequal distribution — for example, set 2 columns to 30 and 70 to make the first column narrow and the second wide
  • The column widths should add up to 100%

Responsive columns ​

The screen width at which the multi-column layout automatically stacks into a single column. Available options:

  • inherit: Uses the global responsive configuration in Form style settings
  • Off: No stacking; always keeps the multi-column layout
  • Phone portrait (479px): Stacks into a single column on portrait phones (below 479px)
  • Phone landscape (767px): Stacks into a single column on landscape phones (below 767px)
  • Tablet landscape (1024px): Stacks into a single column on landscape tablets (below 1024px)

Responsive suggestions

  • On mobile, we recommend stacking into a single column for a good reading experience on small screens
  • The larger the chosen breakpoint (e.g., 1024px), the sooner the columns stack into one, improving the mobile experience
  • If inheriting the global setting, configure it centrally in the Responsive columns section of Form style settings

Logic ​

Enable conditional logic ​

When enabled, configure rules to show or hide the entire row (including all elements within the row) based on the user's input in other fields.

Rule match mode ​

After enabling conditional logic, first set the rule match mode:

  • Match any condition (any): The entire row shows or hides when any one rule is satisfied
  • Match all conditions (all): The entire row shows only when all rules are satisfied

Configure rules ​

Each rule consists of three parts:

PartDescription
FieldSelect a target field from the dropdown (displays the field's Label)
OperatorThe comparison condition
ValueThe target value to compare against

Supported operators ​

OperatorDescription
isTriggers when the field value equals the specified value
is notTriggers when the field value does not equal the specified value
is emptyTriggers when the field value is empty
is not emptyTriggers when the field value is not empty

Add and manage rules ​

  • Click the Add logic rule button to add a new rule
  • Click the 🗑 button on the right of each rule to delete it
  • Click the + button to add more match conditions

Use cases

Row conditional logic controls all elements within the row simultaneously. For example, when the user selects "International shipping", show the row containing "Country", "City", and "Zip Code" fields:

  • Match mode: Match any condition
  • Field: Shipping method
  • Operator: is
  • Value: International shipping

Advanced ​

Unique ID (required) ​

The unique identifier of the row. Unlike other regular elements, the Row's Unique ID is editable and can be set manually.

Layout container

Row is a layout container element that produces no submission data, so it has no validators, filters, Data, or other settings. It arranges fields side by side in multiple columns.

Row vs Group ​

FeatureGroupRow
PurposeVisual grouping (border + heading)Multi-column side-by-side layout
Column count control❌✅ (1-10 columns)
Column width customization❌✅ (percentage)
Responsive breakpoint❌✅ (configurable stacking)
Group style✅ (Default/Show Title/Blank)❌

Using together

Group and Row can be nested. For example, place multiple Rows inside a Group to create a complex multi-column layout with headings.

Next steps ​

Built with VitePress