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

# Time Dropdown

> Time Dropdown allows your users to select time periods in your dashboards.

<img src="https://mintcdn.com/explo/CaJC4DeBEWf_KlnL/images/creating-dashboards/time-dropdown-1.png?fit=max&auto=format&n=CaJC4DeBEWf_KlnL&q=85&s=5fe9f549f8c7305c660e6efc6c86a9c4" alt="Time Dropdown element" width="228" height="244" data-path="images/creating-dashboards/time-dropdown-1.png" />

## What it does

This element allows your users to select time periods in your dashboards.

<img src="https://mintcdn.com/explo/CaJC4DeBEWf_KlnL/images/creating-dashboards/time-dropdown-2.png?fit=max&auto=format&n=CaJC4DeBEWf_KlnL&q=85&s=024736c2991d56b0dc8c86eb1e05da15" alt="Example of configured Time Dropdown" width="432" height="389" data-path="images/creating-dashboards/time-dropdown-2.png" />

## Configuration

<img src="https://mintcdn.com/explo/CaJC4DeBEWf_KlnL/images/creating-dashboards/time-dropdown-3.png?fit=max&auto=format&n=CaJC4DeBEWf_KlnL&q=85&s=40253b28612cad310747ddd76507119e" alt="" width="432" height="549" data-path="images/creating-dashboards/time-dropdown-3.png" />

<img src="https://mintcdn.com/explo/CaJC4DeBEWf_KlnL/images/creating-dashboards/time-dropdown-4.png?fit=max&auto=format&n=CaJC4DeBEWf_KlnL&q=85&s=3e2b314671cc02924ebb401300fe7877" alt="" width="432" height="669" data-path="images/creating-dashboards/time-dropdown-4.png" />

### Basic Configuration

Available by accessing the `Setup` and `Preferences` tabs

| Configuration Option        | Description                                                                                                                                                                                                           |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Set Filter Values           | In this section, you can add and reorder options your users can select from. You choose the name of the value (ex. Last 7 days) and the minutes that represents (ex. 10,080).                                         |
| Default Value               | Set the default selection for the Time Dropdown                                                                                                                                                                       |
| Label                       | Set the label your users see for the dropdown                                                                                                                                                                         |
| Enable Filtering            | Allow your users to search within the dropdown for values                                                                                                                                                             |
| Enable Clearing Selection   | Allow your users to clear the dropdown with an X                                                                                                                                                                      |
| Use Portal for Popover      | When enabled, prevents the dropdown options from being hidden when overflowing. Applicable to both overflow from a container and the embed component itself.                                                          |
| Enable Dependency Selection | When enabled, you may create a dependency between this element and other elements on the dashboard. When this element is dependent on an element selected, it will be disabled until a value is selected by the user. |

## Variable Usage

In the SQL query, use the following syntax

```sql theme={null}
WHERE 1=1
[[AND DATE_DIFF(CURRENT_TIMESTAMP(), timestamp, MINUTE) < {{time_period_dropdown_1}}]]
```

## Filtering

You can now filter directly your charts in the UI elements themselves. For more information on this process, see the [filtering section of the overview page](/creating-dashboards/ui-elements#filtering).
