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

# Target Comparison

> Define a custom target comparison option for a comparison_selector

```liquid theme={null}
{% target_comparison 
    name="vs Budget" 
    target="budget_amount"
/%}
```

## Examples

### Compare vs Budget

```liquid theme={null}
{% target_comparison 
    name="vs Budget" 
    target="budget_amount"
/%}
```

### Compare vs Fixed Goal

```liquid theme={null}
{% target_comparison 
    name="vs 100K Goal" 
    target="100000"
/%}
```

### Compare vs Aggregated Target

```liquid theme={null}
{% target_comparison 
    name="vs Target" 
    target="sum(target_sales)"
/%}
```

## Attributes

<ResponseField name="name" type="string" required>
  Display name shown in the dropdown (e.g., "vs Budget")
</ResponseField>

<ResponseField name="target" type="string" required>
  Target value for comparison. Can be a column name, aggregation (e.g., "sum(budget)"), or literal value.
</ResponseField>

<ResponseField name="display_type" type="string">
  Default display type for this comparison. Options: pct (percentage change), abs (absolute change), compared\_value (target value)

  **Allowed values:**

  * `pct`
  * `abs`
  * `compared_value`
</ResponseField>

<ResponseField name="text" type="string">
  Custom comparison label text (overrides default "vs {name}")
</ResponseField>

<ResponseField name="pct_fmt" type="string">
  Format code for percentage values. See [Value Formatting](/core-concepts/value-formatting) for available formats.
</ResponseField>

<ResponseField name="abs_fmt" type="string">
  Format code for absolute values. See [Value Formatting](/core-concepts/value-formatting) for available formats.
</ResponseField>

<ResponseField name="down_is_good" type="boolean" default="false">
  If true, negative changes are shown as positive (green)
</ResponseField>

## Allowed Parents

* [comparison\_selector](/components/comparison_selector)