> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

# null_display - Dimensions

> Sets the text a table chart shows for null values of a dimension.

export const field_0 = "dimension"

Sets the text a [table visualization][table-vis] shows in place of the default null symbol (`∅`) for this dimension's null values.

## Syntax

```yaml theme={null}
<dimension_name>:
  null_display: "<text>"
```

## Properties

<ParamField path="dimension_name" type="object">
  The name of the dimension.

  <Expandable title="dimension_name properties" defaultOpen="true">
    <ParamField path="null_display" type="string">
      The text to display for null values of this dimension in table chart cells.
    </ParamField>
  </Expandable>
</ParamField>

## Behavior

A table chart resolves a cell's null text in this order:

1. The column's [**Null display** setting](/visualize-present/visualizations/types/table#field-options)
2. The {field_0}'s `null_display` value.
3. The table's [**Null display** setting](/visualize-present/visualizations/types/table#table-options).
4. The default `∅` symbol.

To show a blank cell for a {field_0} with `null_display` set, set the [column's **Null display** setting](/visualize-present/visualizations/types/table#field-options), or set `null_display` to an empty string (`""`).

An empty string is a valid value for `null_display` and displays as a blank cell. This is different from leaving `null_display` unset, in which case the table's setting is used instead.

<Note>
  `null_display` only affects table chart cells and subtotal rows. The Results table, pivot headers, the formula bar, and downloads always show `∅` for null values.
</Note>

## Examples

### Descriptive null text

```yaml title="customers.view" theme={null}
dimensions:
  region:
    sql: '"region"'
    null_display: Unassigned
```

### Explicit blank value

```yaml title="orders.view" theme={null}
dimensions:
  cancellation_reason:
    sql: '"cancellation_reason"'
    null_display: ""
```

[table-vis]: /visualize-present/visualizations/types/table


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.