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

# IAddSectionItemsPayload

- 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 [IAddSectionItems](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddsectionitems/index.md) command.

**Signature:**

```typescript
export interface IAddSectionItemsPayload 
```

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [autoResolveDateFilterDataset?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddsectionitemspayload/index.md#iaddsectionitemspayloadautoresolvedatefilterdataset) | `readonly` | boolean | **_(BETA)_** _(Optional)_ Specify whether dashboard should auto-resolve date dataset to use for date filtering of KPI and insight widgets. |
| [itemIndex](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddsectionitemspayload/index.md#iaddsectionitemspayloaditemindex) | `readonly` | [RelativeIndex](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.relativeindex/index.md) | **_(BETA)_** Index within section items where the item should be inserted. |
| [itemPath?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddsectionitemspayload/index.md#iaddsectionitemspayloaditempath) | `readonly` | [ILayoutItemPath](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ilayoutitempath/index.md) | **_(BETA)_** _(Optional)_ Path to which the item should be added. |
| [items](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddsectionitemspayload/index.md#iaddsectionitemspayloaditems) | `readonly` | [DashboardItemDefinition](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.dashboarditemdefinition/index.md)[] | **_(BETA)_** Items to add. This item may be a placeholder for KPI or insight, an actual dashboard widget or a previously stashed dashboard item. |
| [sectionIndex](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddsectionitemspayload/index.md#iaddsectionitemspayloadsectionindex) | `readonly` | number | **_(BETA)_** Section to which the item should be added. |

## Property details

### IAddSectionItemsPayload.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`.

### IAddSectionItemsPayload.itemIndex

> **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 within section items where the item should be inserted.

**Signature:**

```typescript
readonly itemIndex: RelativeIndex;
```

#### Remarks

Index is zero-based. For convenience, you may specify -1 to append the new item.

[IAddSectionItemsPayload.itemIndex](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddsectionitemspayload/index.md#iaddsectionitemspayloaditemindex) support will be removed in the next major SDK version. Use [IAddSectionItemsPayload.itemPath](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddsectionitemspayload/index.md#iaddsectionitemspayloaditempath) instead.

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

### IAddSectionItemsPayload.itemPath

> **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).
> 

Path to which the item should be added.

**Signature:**

```typescript
readonly itemPath?: ILayoutItemPath;
```

#### Remarks

Index is zero-based.

TODO LX-648: make the prop required

### IAddSectionItemsPayload.items

> **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).
> 

Items to add. This item may be a placeholder for KPI or insight, an actual dashboard widget or a previously stashed dashboard item.

**Signature:**

```typescript
readonly items: DashboardItemDefinition[];
```

#### Remarks

Note: if you use the stashed items identifier, the items will be moved from the stash - you cannot use the stash identifier again.

### IAddSectionItemsPayload.sectionIndex

> **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).
> 

Section to which the item should be added.

**Signature:**

```typescript
readonly sectionIndex: number;
```

#### Remarks

Index is zero-based.

[IAddSectionItemsPayload.sectionIndex](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddsectionitemspayload/index.md#iaddsectionitemspayloadsectionindex) support will be removed in the next major SDK version. Use [IAddSectionItemsPayload.itemPath](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iaddsectionitemspayload/index.md#iaddsectionitemspayloaditempath) instead.

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