File Upload Page

A question page that handles file upload via the CDP file upload service. Must contain a FileUploadField component.

This controller manages the CDP file upload lifecycle: it initiates an upload session with cdp-uploader on each page load, sets the CDP upload URL as the form action so the browser posts files directly to CDP, polls CDP for the upload status on return, and populates session state with completed FileState entries. It is tightly coupled to the CDP file upload service and is the provided implementation for Defra teams. See the File Upload guide for setup instructions, including the required formSubmissionService interface.

Controller value:: "FileUploadPageController"

JSON definition

{
  "path": "/page-path",
  "controller": "FileUploadPageController",
  "title": "Page title",
  "components": []
}

Configuration

Property	Type	Required	Description
`components`	`ComponentDef[]`	Yes	Array of component definitions rendered on the page.
`condition`	`string`	No	Name of a condition that controls whether this page is shown.
`controller`	`ControllerType.FileUpload`	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`	`string`	Yes	URL path segment for the page (e.g. `/details`).
`section`	`string`	No	Name of a section that groups this page in the form.
`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.