GC Design System Components
GC Design System Start to use Page templates overview Basic page Components overview Breadcrumbs Button Card Checkboxes Container Date input Date modified Details Error message Error summary Fieldset File uploader Footer Grid Header Heading Icon Input Language toggle Link Notice Pagination Radios Screenreader-only Search Select Side navigation Signature Stepper Text Textarea Theme and topic menu Top navigation CSS shortcuts overview Reset styles Responsive layout State Box sizing Container sizing Display Overflow Position Visibility Font Font family Font size Font style Font weight Line height Link colour Link size Link text decoration List style Text align Text colour Text overflow Text transform Word break Margin Padding Align content Align items Align self Flex Flex direction Flex grow Flex shrink Flex wrap Gap Grid columns Grid rows Justify content Justify items Justify self Order Place content Place items Place self Background colour Border colour Border radius Border style Border width Icon names Icon size Image Cursor Pointer events Transition Styles overview Design tokens Colour tokens Spacing tokens Typography tokens Contact us Get involved Find a demo

Fieldset
<gcds-fieldset>

Also called: form group.

A fieldset is a group of multiple form components or elements.

  • GitHub
  • Figma

Fieldset component preview

On this page

Coding and accessibility for fieldsets

Heading hierarchy

Use the legend-size attribute to visually place the legend among the headings on the page. Set the attribute value to h2 | h3 | h4 | h5 | h6 to render the fieldset legend to the appropriate size.

Keep hint text static and perceivable

Maintain the default hint attribute to provide additional context so a person can provide a complete value and avoid an error state. This places hint text under the fieldset legend and above the grouping.

Examples Explore the different ways you can configure the component. Each example shows a working implementation and ready-to-copy code.

In this section

Essential attributes These attributes are needed for the component to function correctly.

legend

The legend attribute defines the legend for the fieldset.

<gcds-fieldset legend="Legend" legend-size="h3">
  <gcds-input input-id="form-input" label="Input label">
  </gcds-input>
  <gcds-select select-id="form-select" label="Select label">
    <option value="option-1">Option 1</option>
    <option value="option-2">Option 2</option>
    <option value="option-3">Option 3</option>
  </gcds-select>
</gcds-fieldset>

legend-size

The legend-size attribute sets the appropriate font size for the fieldset legend. The available options are:

  • h2
  • h3
  • h4
  • h5
  • h6

<gcds-fieldset legend="Legend" legend-size="h3">
  <gcds-input input-id="form-input" label="Input label">
  </gcds-input>
  <gcds-select select-id="form-select" label="Select label">
    <option value="option-1">Option 1</option>
    <option value="option-2">Option 2</option>
    <option value="option-3">Option 3</option>
  </gcds-select>
</gcds-fieldset>

Optional attributes These attributes allow you to customize or extend the component’s behaviour and presentation.

hint

The hint attribute defines the hint text displayed under the legend.

<gcds-fieldset legend="Legend" legend-size="h3" hint="Hint / Example message.">
  <gcds-input input-id="form-input" label="Input label">
  </gcds-input>
  <gcds-select select-id="form-select" label="Select label">
    <option value="option-1">Option 1</option>
    <option value="option-2">Option 2</option>
    <option value="option-3">Option 3</option>
  </gcds-select>
</gcds-fieldset>

Slots The default slot allows you to inject custom content into the component’s primary content area, and named slots, into specific areas.

default

The default slot is for placing form elements inside the fieldset.

<gcds-fieldset legend="Legend" legend-size="h3" hint="Hint / Example message.">
  <gcds-input input-id="form-input" label="Input label">
  </gcds-input>
  <gcds-select select-id="form-select" label="Select label">
    <option value="option-1">Option 1</option>
    <option value="option-2">Option 2</option>
    <option value="option-3">Option 3</option>
  </gcds-select>
</gcds-fieldset>

Code builder

Generate an instance of the component you need by selecting its code properties.

  1. Explore by choosing different code values to generate the instance you want.

  2. Get the code and pull it into your environment.

  3. Add any copy you need to the component (like text for a label).

Note: The code builder uses English for all code elements, which follows standard practice.

Help us improve

Have questions or a request? Give feedback on our contact form.

Something's wrong? Raise it through GitHub with an account. You'll have access to the team's direct responses, progress made on your issue, and issues raised by others.

Give feedback Report an issue on GitHub
2026-05-20