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

# ITableValueColumnDefinition

- Package: [@gooddata/sdk-ui](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/index.md)
- Kind: type-alias
- Stability: alpha
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-ui/src/base/results/tableData/interfaces/columns.ts

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Defines columns that contain actual data values (values and subtotals).

\*\*What it does:\*\* These columns show your actual data - sales numbers, counts, percentages, etc. The `columnScope` tells you exactly what this column represents.

\*\*When it's created:\*\* The system creates these based on your column headers. Here's how:

\*\*Simple case - just measures:\*\*

```tsx
| Country | Sales | Profit |  <- Sales and Profit are value columns
|---------|-------|--------|
| USA     | 100   | 20     |
```
\*\*Pivoted case - attributes + measures in columns:\*\*

```tsx
| Country | East Sales | East Profit | West Sales | West Profit |
|---------|------------|-------------|------------|-------------|
| USA     | 100        | 20          | 150        | 30          |
```
\*\*Transposed case - measures in rows, attributes in columns:\*\*

```tsx
| Country | Measure | East | West |
|---------|---------|------|------|
| USA     | Sales   | 100  | 150  |
| USA     | Profit  | 20   | 30   |
```

**Signature:**

```typescript
export type ITableValueColumnDefinition = {
    type: "value";
    columnIndex: number;
    columnHeaderIndex: number;
    columnScope: ITableDataHeaderScope[];
} & (/**
   * Handles case, when pivoting and measures are in rows.
   */ {
    isEmpty: false;
    isTransposed: true;
    attributeHeader: IResultAttributeHeader;
    attributeDescriptor: IAttributeDescriptor;
}
/**
 * Handles standard pivoting case without transposition.
 */
 | {
    isEmpty: false;
    isTransposed: false;
    measureHeader: IResultMeasureHeader;
    measureDescriptor: IMeasureDescriptor;
}
/**
 * Handles case, when pivoting, but there are no measures.
 */
 | {
    isEmpty: true;
    isTransposed: false;
    attributeHeader: IResultAttributeHeader;
    attributeDescriptor: IAttributeDescriptor;
});
```
**References:** [ITableDataHeaderScope](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui/sdk-ui.itabledataheaderscope/index.md), [IResultAttributeHeader](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iresultattributeheader/index.md), [IAttributeDescriptor](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iattributedescriptor/index.md), [IResultMeasureHeader](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iresultmeasureheader/index.md), [IMeasureDescriptor](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imeasuredescriptor/index.md)