> ## 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.
# Slider
> A numeric slider input that can be used in filters
```liquid theme={null}
{% slider
id="sales_filter"
data="demo.daily_orders"
value_column="total_sales"
title="Sales Amount"
/%}
{% bar_chart
data="demo.daily_orders"
x="date"
y="sum(total_sales)"
filters=["sales_filter"]
date_grain="month"
/%}
```
## Examples
### Using `filters`
```liquid theme={null}
{% slider
id="sales_filter"
data="demo.daily_orders"
value_column="total_sales"
title="Sales Amount"
/%}
{% bar_chart
data="demo.daily_orders"
x="date"
y="sum(total_sales)"
filters=["sales_filter"]
date_grain="month"
/%}
```
### Using `where`
```liquid theme={null}
{% slider
id="sales_filter"
data="demo.daily_orders"
value_column="total_sales"
range=true
/%}
{% table
data="demo.daily_orders"
where="total_sales {{sales_filter.between}}"
/%}
```
### Using Inline SQL
````liquid theme={null}
{% slider
id="sales_filter"
data="demo.daily_orders"
value_column="total_sales"
range=true
/%}
```sql filtered_orders
select * from demo.daily_orders
where total_sales {{sales_filter.between}}
```
{% table data="filtered_orders" /%}
````
## Attributes
The id of the slider to be used in a `filters` prop
Text displayed above the slider
Information tooltip text
URL to link the info text to (can only be used with info)
Create a custom link title for the info link, placed after the info text (can only be used with info\_link)
Name of the table to query for min/max values
SQL expression to get min/max values from. When provided with data, queries MIN(value\_column) and MAX(value\_column) to set the slider range.
Minimum value for the slider
Maximum value for the slider
Step size for the slider (must be greater than 0)
If true, automatically adjusts min/max to align with step boundaries for cleaner numbers (e.g., range 15-103818 with step=10000 becomes 0-110000)
Format code for the slider values (e.g., "num", "usd", "pct"). See formatValue documentation for available formats. See [Value Formatting](/core-concepts/value-formatting) for available formats.
If true, enables range mode with two handles for selecting a min/max range
Initial selected value (number for single value, \[min, max] array for range mode)
If true, shows a number input next to the slider value for direct editing
Use date\_range to filter data for specific time periods. Accepts predefined ranges (e.g., "last 12 months"), dynamic ranges (e.g., "Last 90 days"), custom date ranges (e.g., "2020-01-01 to 2023-03-01"), or partial ranges (e.g., "from 2020-01-01", "until 2023-03-01")
**Example:**
```
date_range={
range = "today"
date = "string"
}
```
**Attributes:**
* range: `string` - Time period to filter. Use presets like 'last 7 days', dynamic patterns like 'Last 90 days', custom ranges like '2020-01-01 to 2023-03-01', or partial ranges like 'from 2020-01-01'.
* **Allowed values:**
* `today`
* `yesterday`
* `last 7 days`
* `last 30 days`
* `last 3 months`
* `last 6 months`
* `last 12 months`
* `previous week`
* `previous month`
* `previous quarter`
* `previous year`
* `this week`
* `this month`
* `this quarter`
* `this year`
* `next week`
* `next month`
* `next quarter`
* `next year`
* `week to date`
* `month to date`
* `quarter to date`
* `year to date`
* `all time`
* date: `string` - Date column to filter on. Required when the data has multiple date columns.
## 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` | | `500` |
| `where` attribute | `.value` | | `500` |
| Text / Markdown | `.value` | | `500` |
### Available Properties
You can also access specific properties using `{{filter_id.property}}`:
#### .value
Returns the numeric slider value, or the selected range when in range mode.
````liquid theme={null}
{% slider id="age_filter" data="users" value_column="age" /%}
```sql filtered_users
select * from users
where age >= {{age_filter}}
```
````
**Example value:** `500`
#### .filter
Returns a complete SQL filter expression. Returns `true` when no value is selected. Only available when `value_column` is provided.
````liquid theme={null}
{% slider id="age_filter" data="users" value_column="age" /%}
```sql filtered_users
select * from users
where {{age_filter.filter}}
```
````
**Example value:** `age >= 25`
#### .literal
Returns the raw numeric value. Only available in single value mode.
````liquid theme={null}
{% slider id="price_filter" min=0 max=1000 /%}
```sql filtered_products
select * from products
where price >= {{price_filter.literal}}
```
````
**Example value:** `500`
#### .min
Returns the minimum value of the selected range. Only available when range mode is enabled.
````liquid theme={null}
{% slider id="age_filter" data="users" value_column="age" range=true /%}
```sql filtered_users
select * from users
where age >= {{age_filter.min}}
```
````
**Example value:** `25`
#### .max
Returns the maximum value of the selected range. Only available when range mode is enabled.
````liquid theme={null}
{% slider id="age_filter" data="users" value_column="age" range=true /%}
```sql filtered_users
select * from users
where age <= {{age_filter.max}}
```
````
**Example value:** `65`
#### .between
Returns a SQL BETWEEN clause fragment. Only available when range mode is enabled.
````liquid theme={null}
{% slider id="price_filter" min=0 max=1000 range=true /%}
```sql filtered_products
select * from products
where sale_price {{price_filter.between}}
```
````
**Example value:** `BETWEEN 25 AND 65`