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

# IReplaceSectionItemPayload

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

**Signature:**

```typescript
export interface IReplaceSectionItemPayload 
```

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [autoResolveDateFilterDataset?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ireplacesectionitempayload/index.md#ireplacesectionitempayloadautoresolvedatefilterdataset) | `readonly` | boolean | **_(BETA)_** _(Optional)_ Specify whether dashboard should auto-resolve date dataset to use for date filtering of the KPI or insight widget that will be used to replace item on a dashboard. |
| [item](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ireplacesectionitempayload/index.md#ireplacesectionitempayloaditem) | `readonly` | [DashboardItemDefinition](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.dashboarditemdefinition/index.md) | **_(BETA)_** New item definition. |
| [itemIndex](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ireplacesectionitempayload/index.md#ireplacesectionitempayloaditemindex) | `readonly` | number | **_(BETA)_** Index of item within section that should be modified. |
| [itemPath?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ireplacesectionitempayload/index.md#ireplacesectionitempayloaditempath) | `readonly` | [ILayoutItemPath](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ilayoutitempath/index.md) | **_(BETA)_** _(Optional)_ Index where the item to modify resides. TODO LX-648: make the prop required |
| [sectionIndex](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ireplacesectionitempayload/index.md#ireplacesectionitempayloadsectionindex) | `readonly` | number | **_(BETA)_** Index of section where the item to modify resides. |
| [stashIdentifier?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.ireplacesectionitempayload/index.md#ireplacesectionitempayloadstashidentifier) | `readonly` | [StashedDashboardItemsId](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.stasheddashboarditemsid/index.md) | **_(BETA)_** _(Optional)_ Specify identifier for stash where the old item should be stored. |

## Property details

### IReplaceSectionItemPayload.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 the KPI or insight widget that will be used to replace item on a dashboard.

**Signature:**

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

#### Remarks

This is by default disabled. Meaning date filtering will be enabled only if the KPI or Insight widget already specifies dateDataset. If the dateDataset is `undefined` the widget 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`.

### IReplaceSectionItemPayload.item

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

New item definition.

**Signature:**

```typescript
readonly item: DashboardItemDefinition;
```

### IReplaceSectionItemPayload.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 of item within section that should be modified.

**Signature:**

```typescript
readonly itemIndex: number;
```

#### Remarks

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

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

### IReplaceSectionItemPayload.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).
> 

Index where the item to modify resides.

TODO LX-648: make the prop required

**Signature:**

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

### IReplaceSectionItemPayload.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).
> 

Index of section where the item to modify resides.

**Signature:**

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

#### Remarks

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

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

### IReplaceSectionItemPayload.stashIdentifier

> **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 identifier for stash where the old item should be stored.

**Signature:**

```typescript
readonly stashIdentifier?: StashedDashboardItemsId;
```

#### Remarks

If no stashIdentifier provided, then the old item will be thrown away.