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

# newDimension()

- Package: [@gooddata/sdk-model](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/index.md)
- Kind: function
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-model/src/execution/base/dimension.ts
- Guides: [Execution model](https://www.gooddata.ai/docs/gooddata-ui/latest/data-layer/execution/execution-model/index.md), [Result structure](https://www.gooddata.ai/docs/gooddata-ui/latest/data-layer/execution/result-structure/index.md)

Creates new single-dimensional specification where the dimension will have the provided set of identifiers.

**Signature:**

```typescript
export declare function newDimension(items?: DimensionItem[], totals?: ITotal[]): IDimension;
```

## Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| items | [DimensionItem](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.dimensionitem/index.md)[] | _(Optional)_ allows for mix of item identifiers, attributes and total definitions to have in the new dimension |
| totals | [ITotal](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.itotal/index.md)[] | _(Optional)_ additional totals to add to the dimension |

**Returns:**

[IDimension](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.idimension/index.md)

single dimension