Skip to main content
Version: 1.28 (Current)

Forms 2.0 - Responsive

caution

This page is preliminary and subject to change as Forms 2.0 continues to be developed.

The same form can be shown on a phone, beside other content on a page, or across a wide screen. In Forms 2.0, you make it fit each case by giving its containers a different layout for each form width.

Form widths​

Forms 2.0 sorts every form into one of three widths:

WidthThe form isTypical case
NarrowUnder 768 px widePhones, side panels, narrow page columns
Medium768 to 1199 px wideTablets, a form beside other content
Wide1200 px wide and overFull-page forms on a desktop

The width is the width of the form itself, not of the browser window. A form in a narrow column of a wide page is a Narrow form, even on a large monitor. The form measures its width as the page loads and again whenever it changes, for example when the user rotates a tablet or resizes the window, and switches layout straight away.

What can change with the width​

On every container - the form's root container, Layout Container, Section, Dynamic Container, and Repeater - these settings can have one value per width:

SettingExample
Layout ModeHorizontal on Medium and Wide, Vertical on Narrow, so side-by-side fields stack on phones
AlignmentButtons right-aligned on Wide, left-aligned on Narrow
GapLoose on Wide, Compact on Narrow
Padding24px on Wide, 8px 0px on Narrow

Other settings, such as Columns, and the position and width of fields in a Manual container, are the same at every width.

Nothing changes by itself: a container with one value for a setting uses it at every width. A Horizontal container stays side by side on a phone, with each field narrower, until you give it a different Narrow value.

Setting a value per width​

  1. In the Form Builder, select the container. To change the root container, click an empty area of the Canvas.
  2. Next to the setting, click the device icon. The setting now has a separate value for each width, starting with its current value for all three.
  3. Use the Narrow, Medium, and Wide buttons above the Canvas to pick the width you're editing. The setting's title shows it, for example Layout Mode (Narrow width).
  4. Set the value for that width. The Canvas shows the result straight away.
  5. Repeat for the other widths, then click Save.

To go back to one value for every width, click the device icon again. The value for the current width then applies to all of them.

Previewing​

The toolbar above the Canvas sets the preview width. Click Narrow, Medium, or Wide, type an exact width in Width, or drag the handle at the side of the Canvas. The highlighted button shows which width's values are in use, so dragging the handle shows where the layout switches. See Canvas width.

Check the live page on a real phone too, since fonts and the page's own styles can differ from the preview.

Common patterns​

Stack two columns on phones​

A Horizontal container with two Vertical containers inside, as in Two columns:

  • Outer container Layout Mode: Horizontal for Medium and Wide, Vertical for Narrow.

On a phone, the second column moves below the first.

A Manual grid on wide forms only​

A Manual container with City (half), State and Zip (a quarter each) looks cramped on a phone:

  • Layout Mode: Manual for Medium and Wide, Vertical for Narrow.

On a phone, the fields stack one per row. Preview the Narrow width to check that they stack in the order you want.

Tighter spacing on small forms​

  • Root container Gap: Normal for Medium and Wide, Compact for Narrow.
  • Root container Padding: 16px for Wide, 8px 0px for Narrow and Medium.

Styling with CSS​

The form's root container gets the class paa-width-narrow, paa-width-medium, or paa-width-wide, matching its current width. Use it in your site's CSS for anything the settings don't cover, for example hiding a decorative image on Narrow forms:

.paa-width-narrow .hero-image { display: none; }

Last updated: November 18, 2026