> Documentation index: https://www.gooddata.ai/docs/gooddata-ui/llms.txt lists every page of these docs as Markdown.

# IAddLayoutSectionPayload

- Package: [@gooddata/sdk-ui-dashboard](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/index.md)
- Kind: interface
- Stability: beta
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-ui-dashboard/src/model/commands/layout.ts

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Payload of the [IAddLayoutSection](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddlayoutsection/index.md) command.

**Signature:**

```typescript
export interface IAddLayoutSectionPayload 
```

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [autoResolveDateFilterDataset?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddlayoutsectionpayload/index.md#iaddlayoutsectionpayloadautoresolvedatefilterdataset) | `readonly` | boolean | **_(BETA)_** _(Optional)_ Specify whether dashboard should auto-resolve date dataset to use for date filtering of KPI and insight widgets. |
| [index](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddlayoutsectionpayload/index.md#iaddlayoutsectionpayloadindex) | `readonly` | [RelativeIndex](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.relativeindex/index.md) \| [ILayoutSectionPath](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ilayoutsectionpath/index.md) | **_(BETA)_** Index where to place the new section |
| [initialHeader?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddlayoutsectionpayload/index.md#iaddlayoutsectionpayloadinitialheader) | `readonly` | [IDashboardLayoutSectionHeader](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.idashboardlayoutsectionheader/index.md) | **_(BETA)_** _(Optional)_ Specify the section header. |
| [initialItems?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddlayoutsectionpayload/index.md#iaddlayoutsectionpayloadinitialitems) | `readonly` | [DashboardItemDefinition](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.dashboarditemdefinition/index.md)[] | **_(BETA)_** _(Optional)_ Specify one or more items to include in the newly created section. |

## Property details

### IAddLayoutSectionPayload.autoResolveDateFilterDataset

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Specify whether dashboard should auto-resolve date dataset to use for date filtering of KPI and insight widgets.

**Signature:**

```typescript
readonly autoResolveDateFilterDataset?: boolean;
```

#### Remarks

This is by default disabled. Meaning date filtering will be enabled only for those KPI or Insight widgets that already specify dateDataset. Those that have dateDataset `undefined` will not be filtered by dashboard's date filter.

When you turn on this option, then the dashboard will automatically resolve date dataset for those KPI and Insight widgets that have it `undefined`.

### IAddLayoutSectionPayload.index

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Index where to place the new section

**Signature:**

```typescript
readonly index: RelativeIndex | ILayoutSectionPath;
```

#### Remarks

Index is zero-based and for convenience index -1 means place new section at the end. 0 means place new section at the beginning. Both 0 and -1 and can be used when inserting the first section into and empty layout.

[RelativeIndex](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.relativeindex/index.md) support will be removed in the next major SDK version. Use [ILayoutSectionPath](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ilayoutsectionpath/index.md) instead.

TODO LX-648: Remove RelativeIndex type in the next major version.

### IAddLayoutSectionPayload.initialHeader

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Specify the section header.

**Signature:**

```typescript
readonly initialHeader?: IDashboardLayoutSectionHeader;
```

### IAddLayoutSectionPayload.initialItems

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Specify one or more items to include in the newly created section.

**Signature:**

```typescript
readonly initialItems?: DashboardItemDefinition[];
```