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

# eagerRemoveSectionItemByWidgetRef()

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

Creates the RemoveSectionItemByWidgetRef configured to do eager remove of item.

**Signature:**

```typescript
export declare function eagerRemoveSectionItemByWidgetRef(widgetRef: ObjRef, stashIdentifier?: StashedDashboardItemsId, correlationId?: string): IRemoveSectionItemByWidgetRef;
```

## Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| widgetRef | [ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md) | widget reference of the item to remove; |
| stashIdentifier | [StashedDashboardItemsId](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.stasheddashboarditemsid/index.md) | _(Optional)_ stash identifier to store the removed item under; if not specified the item will be removed |
| correlationId | string | _(Optional)_ specify correlation id to use for this command. this will be included in all events that will be emitted during the command processing |

**Returns:**

[IRemoveSectionItemByWidgetRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.iremovesectionitembywidgetref/index.md)

## Remarks

Dispatching this command will result in removal of the item from a section and if the section only contains that item then the whole section will be removed as well.

You may optionally specify the stashIdentifier in order to stash the removed item for later resurrection.