submit-social-housing-lettings-and-sales-data/docs/form/page.md

---
parent: Form definition
grand_parent: Generating forms
nav_order: 3
---

# Page

Pages sit below the [`Subsection`](subsection) level of a form definition.

An example page might look something like this:

```
class Form::Sales::Pages::PropertyPostcode < ::Form::Page
  def initialize(id, hsh, subsection)
    super
    @id = property_postcode
    @depends_on = [{ "needstype" => 1 }]
    @title_text = {
      "translation": "translation1",
      "arguments": [
        {
          "key": "some_general_field",
          "label": true,
          "i18n_template": "template1"
        }
      ]
    }
    @informative_text": {
      "translation": "translation2",
      "arguments": [
        {
          "key": "some_currency_method",
          "label": false,
          "i18n_template": "template2",
          "currency": true,
        }
      ]
    }
  end

  def questions
    @questions ||= [
      Form::Sales::Questions::Question.new(nil, nil, self),
    ]
  end
end
```

In the above example the the subsection has the id `property_postcode`. This id is used for the url of the web page, but the underscore is replaced with a dash, so the url for this page would be `[environment-url]/logs/[log-id]/property-postcode` e.g. on staging this url might look like the following: `https://staging.submit-social-housing-data.communities.gov.uk/logs/1234/property-postcode`.

The header is optional but if provided is used for the heading displayed on the page.

The description is optional but if provided is used for a paragraph displayed under the page header.

It’s worth noting that like subsections a page can also have a `depends_on` which contains the set of conditions that must be met for the section to be accessible to a data provider. If the conditions are not met then the page is not routed to as part of the form flow. The `depends_on` for a page will usually depend on answers given to questions, most likely to be questions in the setup section. In the above example the page is dependent on the answer to the `needstype` question being `1`, which corresponds to picking `General needs` on that question as displayed to the data provider.

Pages can contain one or more [questions](question).