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

# newDashboardItem()

- Package: [@gooddata/sdk-ui-dashboard](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/index.md)
- Kind: function
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-ui-dashboard/src/model/types/layoutTypes.ts

Creates a new dashboard item containing the provided custom widget.

**Signature:**

```typescript
export declare function newDashboardItem<T = ExtendedDashboardWidget>(widget: T, sizeOrColSize: IDashboardLayoutSizeByScreenSize | number): ExtendedDashboardItem<T>;
```

## Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| widget | T | custom widget to include |
| sizeOrColSize | [IDashboardLayoutSizeByScreenSize](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.idashboardlayoutsizebyscreensize/index.md) \| number | item size specification; for convenience you can specify the size as number which will be interpreted as number of columns in a 12-col grid that the item should use when rendered on an XL screen. |

**Returns:**

[ExtendedDashboardItem](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.extendeddashboarditem/index.md)&lt;T&gt;