Fieldset
`<gcds-fieldset>`

Also called: form group.

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

GitHub
Figma

Fieldset component preview

Coding and accessibility for fieldsets

Choose the heading level

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 legend.

Add hint text

Use the hint attribute to add hint text.
Avoid adding hint text in the field where it will disappear once the field is selected or a response starts to be entered.

Add form components

Add form components to the fieldset grouping:
- gcds-checkboxes
- gcds-date-input
- gcds-file-uploader
- gcds-input
- gcds-radios
- gcds-select
- gcds-textarea
Follow the respective guidance for each component within fieldset.

Examples

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

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.

Explore by choosing different code values to generate the instance you want.
Get the code and pull it into your environment.
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-06-10

Fieldset<gcds-fieldset>