> ## 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.

# bin_boundaries

> Specifies bins or tiers for a given numeric field.

Bin text cannot be configured, but you can use a `CASE` statement to explicitly set text.

## Limitations

This parameter can only be used with numeric fields. Use [`groups`](/modeling/dimensions/parameters/groups) for string fields.

## Syntax

```yaml theme={null}
<dimension_name>:
  sql: ${<view_name>.<field_name>}
  bin_boundaries: [<boundary_1>, <boundary_2>, ...]
```

## Properties

<ParamField path="dimension_name" type="object">
  The name of the dimension. Dimension names must:

  * Be unique within the view
  * Start with a letter
  * Contain only alphanumeric characters and underscores

  <Expandable title="dimension_name properties" defaultOpen="true">
    <ParamField path="bin_boundaries" type="array">
      An array of numeric values that define the boundaries for binning.
    </ParamField>
  </Expandable>
</ParamField>

## Examples

```yaml title="Bins of '< 21', '>= 21 and < 65', and '65 and above'" theme={null}
age_bin:
  sql: ${users.age}
  bin_boundaries: [21, 65]
  label: Age Bins
```