> ## 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.
# Toggle
> Display a toggle switch that outputs true/false values for use in filters
```liquid theme={null}
{% toggle
id="show_legend"
label="Show Legend"
/%}
```
## Examples
### Basic Usage
```liquid theme={null}
{% toggle
id="show_legend"
label="Show Legend"
/%}
```
### Using `where`
```liquid theme={null}
{% toggle
id="active_only"
label="Active Only"
/%}
{% table
data="demo.daily_orders"
where="{{active_only}} = false or total_sales > 1000"
/%}
```
### Using Inline SQL
````liquid theme={null}
{% toggle
id="active_only"
label="Active Only"
/%}
```sql filtered_orders
select * from demo.daily_orders
where {{active_only}} = false or total_sales > 1000
```
{% table data="filtered_orders" /%}
````
## Attributes
The id of the toggle to be used in a `filters` prop
Text displayed next to the toggle inside the box. Defaults to the id if not provided.
Information tooltip text that appears after the label
Invert the boolean value output. When true, checked = false and unchecked = true. Useful when toggle label semantics are opposite to the filter logic (e.g., a "Show inactive" toggle that filters for is\_active = false when checked).
Initial state of the toggle
## Using the Filter Variable
Reference this filter using `{{filter_id}}`. The value returned depends on where you use it.
| Context | Default Property | No Selection | Result |
| ----------------- | ---------------- | ------------ | ------ |
| Inline SQL query | `.value` | | `true` |
| `where` attribute | `.value` | | `true` |
| Text / Markdown | `.value` | | `true` |
### Available Properties
You can also access specific properties using `{{filter_id.property}}`:
#### .value
Returns the boolean value of the toggle.
````liquid theme={null}
{% toggle id="active_filter" /%}
```sql active_users
select * from users
where is_active = {{active_filter}}
```
````
**Example value:** `true`