Components

Fieldset

Use the fieldset component to group related form fields and labels within a form.

Examples

Interact with the example to see how it works.

When to use this component

Use the fieldset component when you need to show a relationship between multiple form inputs. For example, you may need to group a set of text inputs into a single fieldset when asking for an address.

If you’re using the radio buttons, checkboxes or date input components, the fieldset component will already be included.

How it works

The first element inside a <fieldset> must be a <legend> which describes the group of inputs. This could be a question, such as ‘What is your current address?’ or a statement like ‘Personal details’.

If you’re asking just one question per page as recommended, you can set the contents of the <legend> as the page heading, as shown in the example below. This is good practice as it means that users of screen readers will only hear the contents once.

On question pages containing a group of inputs, including the question as the legend helps users of screen readers to understand that the inputs are all related to that question.

Include in the legend any general help text which is important for filling in the form and cannot be written as hint text, but try to keep it as concise as possible.

Credit

Guidance, original HTML and CSS derived from GOV.UK Design System.

Get in touch

If you’ve got a question, idea, or suggestion, email the Design System (DS) team at info@digital.govt.nz, use our AOG-DS Slack app, or discuss Fieldset on 'GitHub issues'.