Color

Inputs come in two different colors. The default input color is $field-01 and is used on $ui-background and $ui-02 page backgrounds. The --light version input color is $field-02 and is used on $ui-01 page backgrounds.

Refer to the text input, dropdown, checkbox, radio button, toggle, and button pages for specific typography details on each component.

Example of form fields in the two colors

Example of light fields with $field-02 (left) and the default version with $field-01 (right)

Typography

Form headings and labels should be set in sentence case with the first letter of the first word capitalized. Refer to the text input, dropdown, checkbox, radio button, toggle, and button pages for specific typography details on each component.

PropertyFont-size (px/rem)Font-weightType token
Heading28 / 1.75Regular / 400$heading-03
.bx--label14 / 0.875Regular / 400$label-01
.bx--text-input14 / 0.875Regular / 400$body-short-01
.bx--text-input::placeholder14 / 0.875Regular / 400$body-short-01
.bx--form-requirement12 / 0.75Regular / 400$label-01
.bx--form__helper-text12 / 0.75Regular / 400$helper-text-01

Structure

Forms are made up of several different components. The order in which these elements are arranged is flexible, but should always follow the spacing guidelines below.

Forms can be one column or two. The width of each column varies based on the content and layout of the design. On mobile, forms can only have one column.

All icons can be found on the iconography library page.

ElementPropertypx / remSpacing token
Form itemsmargin-bottom24 / 1.5$spacing-06
Title areamargin-bottom32 / 2$spacing-07
Gutter between items32 / 2$spacing-07
Buttonsmargin-top32 / 2$spacing-07
Structure and spacing measurements for a double column form

Structure and spacing measurements for a double column form | px / rem

Structure and spacing measurements for a single column form

Structure and spacing measurements for a single column form | px / rem