Status Page

The confirmation page shown after a successful form submission. Renders a GOV.UK panel with the page title and, optionally, the reference number. Automatically added to every form at /status — only define it explicitly to customise the title.

The status page is automatically injected into every form at /status if one is not already present in the form definition. You only need to add it explicitly to customise the title.

The submission guidance shown under "What happens next" comes from formMetadata.submissionGuidance, not the form definition itself. Set it on the metadata object returned by your formsService. The value is rendered as Markdown (headings level 3 and below).

Set options.showReferenceNumber to true in the form definition to display the auto-generated reference number inside the confirmation panel. See Form definition options for details.

Controller value:: "StatusPageController"

Preview

Application received

Your reference number
R3K-2WN-P5M

What happens next

We'll review your application and contact you within 10 working days.

What do you think of this service? (takes 30 seconds)

JSON definition

{
  "path": "/status",
  "controller": "StatusPageController",
  "title": "Page title"
}

Configuration

Property	Type	Required	Description
`condition`	`string`	No	Name of a condition that controls whether this page is shown.
`controller`	`ControllerType.Status`	Yes	The page controller class name. Omit or use `"PageController"` for the default question page.
`events`	`Events`	No	Lifecycle hooks that fire when the page is loaded or saved.
`id`	`string`	No	Stable identifier for the page, used internally by the form engine.
`path`	`ControllerPath.Status \| string`	Yes	URL path segment for the page (e.g. `/details`).
`title`	`string`	Yes	Heading displayed to the user at the top of the page.
`view`	`string`	No	Name of an alternative view template to render for this page.