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

# moveSectionItemToNewSection()

- 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 MoveSectionItemToNewSection command.

**Signature:**

```typescript
export declare function moveSectionItemToNewSection(sectionIndex: number, itemIndex: number, toSectionIndex: number, correlationId?: string): IMoveSectionItemToNewSection;
```

## Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| sectionIndex | number | source section index |
| itemIndex | number | index of item to move |
| toSectionIndex | number | target section index; you may specify -1 to move to last section |
| 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 TODO LX-648: Consider removing this command variant and leave only a nested variant |

**Returns:**

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

## Remarks

Dispatching this command will result in move of single item within section or from one section to another.

This command operates only on the root layout. For nested layouts, use [moveNestedLayoutSectionItemToNewSection()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.movenestedlayoutsectionitemtonewsection/index.md).