---
category: [Administration & Integrations, Platform and Product Extensions, Platform and Product Extensions/Integration, Administration & Integrations/Custom Integrations & Apps, Platform and Product Extensions/Workday Extend]
keyword: [Extend, Presentation Components, widgets, tags, UI components]
nav: wcp_docs
parent_url: /wcp_docs/
title: basicFormLayout
layout: subsection
wd_wcptag: basicFormLayout
---

Groups related widgets together in multiple `layoutSection` tags. Each `layoutSection` is a container with a border.

You can only use `basicFormLayout` as the top-level tag within the `body` tag.

## <a id="section_1"></a>Example

This sample `basicFormLayout` divides form fields into 3 sections.

![](GUID-0bf4e86b-b7f5-4983-bcd9-d7b9698a6383-enHYPHENus.png)

```
{
  "type": "basicFormLayout",
  "sections": [
    {
      "type": "layoutSection",
      "children": [
        {
          "type": "readOnlyText",
          "label": "Business Card",
          "value": "Complete these fields to order business cards."
        }
      ]
    },
    {
      "type": "layoutSection",
      "children": [
        {
          "type": "text",
          "label": "Name",
          "id": "name",
          "required": true
        },
        {
          "type": "text",
          "label": "Title",
          "id": "title",
          "required": true
        }
      ]
    },
    {
      "type": "layoutSection",
      "children": [
        {
          "type": "textArea",
          "label": "Address",
          "id": "address",
          "required": true
        },
        {
          "type": "text",
          "label": "Phone",
          "id": "phone",
          "required": true
        },
        {
          "type": "text",
          "label": "Email",
          "id": "email",
          "required": true
        }
      ]
    }
  ]
}
```

## <a id="section-mobile-support"></a>Mobile Support

Android, iOS

## <a id="section_2"></a>Attributes

-   <b>id</b>

    Data type: binding-String

    Unique identifier used to reference this widget from other tags.

    Notes:

    -   The `id` must start with a letter.
    -   The `id` must be unique per page.
    -   To enable other widgets to reference this widget `id`, place this widget before the other widgets on the PMD. The PMD validation returns an "Undefined variable" error if it doesn't find a previously defined `id` in the PMD.
    -   Workday recommends that you include the `id` in your tag definitions for debugging purposes.

-   <b>sections</b>

    Data type: list of `layoutSection` objects

    (Required) Each `layoutSection` contains these attributes:

    -   <b>children</b>

        Data type: list of tags

        An array of tags that belong to this parent tag.

    -   <b>id</b>

        Data type: binding-String

        Unique identifier used to reference this widget from other tags.

        Notes:

        -   The `id` must start with a letter.
        -   The `id` must be unique per page.
        -   To enable other widgets to reference this widget `id`, place this widget before the other widgets on the PMD. The PMD validation returns an "Undefined variable" error if it doesn't find a previously defined `id` in the PMD.
        -   Workday recommends that you include the `id` in your tag definitions for debugging purposes.

    -   <b>render</b>

        Data type: booleanScript

        Indicates whether or not this tag turns into a widget. If true, this tag renders as a widget on the page. If false, the page doesn't add this tag or its children. The default is true.

        Unlike the `visible` attribute, if `render` is false, other tags on the page can't reference this tag or widget on edit pages. On view pages, a tag cannot reference other tags, regardless of the `render` attribute value.