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

# IRemoveSectionItemByWidgetRefPayload

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

**Signature:**

```typescript
export interface IRemoveSectionItemByWidgetRefPayload 
```

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [eager?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iremovesectionitembywidgetrefpayload/index.md#iremovesectionitembywidgetrefpayloadeager) | `readonly` | boolean | **_(BETA)_** _(Optional)_ Specify whether to eagerly remove the entire section if the item being removed was the only item in the section. |
| [stashIdentifier?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iremovesectionitembywidgetrefpayload/index.md#iremovesectionitembywidgetrefpayloadstashidentifier) | `readonly` | [StashedDashboardItemsId](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.stasheddashboarditemsid/index.md) | **_(BETA)_** _(Optional)_ Specify stash identifier. |
| [widgetRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iremovesectionitembywidgetrefpayload/index.md#iremovesectionitembywidgetrefpayloadwidgetref) | `readonly` | [ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md) | **_(BETA)_** Widget reference of the item to remove. |

## Property details

### IRemoveSectionItemByWidgetRefPayload.eager

> **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 to eagerly remove the entire section if the item being removed was the only item in the section.

**Signature:**

```typescript
readonly eager?: boolean;
```

#### Remarks

Default is false. Meaning an empty section will be left.

### IRemoveSectionItemByWidgetRefPayload.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 stash identifier.

**Signature:**

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

#### Remarks

If provided, the item will not be permanently removed but will be stored in the stash under this identifier. You can then use the stash identifier to 'resurrect' the item in different section.

Default behavior with no stashIdentifier is to permanently remove the item as well.

### IRemoveSectionItemByWidgetRefPayload.widgetRef

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

Widget reference of the item to remove.

**Signature:**

```typescript
readonly widgetRef: ObjRef;
```