> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# [Metrics] Como usar filtros e variáveis nos dashboards

Filtros e variáveis deixam os dashboards do Groner Metrics reaproveitáveis: você escreve a consulta uma vez e ela se ajusta ao período, à loja ou a qualquer valor escolhido. Nas consultas, os dois são usados no formato `{{chave}}`.

---

## Filtros (interativos)

Os filtros aparecem no topo do dashboard. Quando o usuário muda o valor, todos os widgets reagem juntos. Exemplos: período, loja, origem.

Tipos de filtro: texto, número, data, período (intervalo), seleção e multi-seleção. As opções de seleção podem ser fixas ou vir de uma consulta SQL.

## Variáveis fixas

São valores que você define uma vez (texto, número, data ou lista), ou que são obtidos por uma consulta. Servem para IDs de status, metas e parâmetros usados em vários widgets.

## Passo a passo

1. Com o dashboard em modo edição, crie o filtro ou a variável e dê uma chave, por exemplo `loja`.
2. Na consulta do widget, use `{{loja}}` onde o valor deve entrar.
3. Teste a consulta e salve.

> **Dica:** ao pedir uma consulta para a IA, ela já considera os filtros criados no dashboard.

<!-- groner-suporte:veja-tambem:inicio -->

## Veja também

- [[Metrics] Como montar o seu primeiro dashboard](https://ajuda.groner.app/pt-br/article/metrics-como-montar-o-seu-primeiro-dashboard-1yl2di6/)
- [[Metrics] SQL ou IA: as duas formas de montar uma consulta](https://ajuda.groner.app/pt-br/article/metrics-sql-ou-ia-as-duas-formas-de-montar-uma-consulta-lcags4/)
- [[Metrics] O que são widgets: gráfico, KPI e tabela](https://ajuda.groner.app/pt-br/article/metrics-o-que-sao-widgets-grafico-kpi-e-tabela-1mp2cqy/)
- [[Metrics] Como compartilhar um dashboard com quem não tem login](https://ajuda.groner.app/pt-br/article/metrics-como-compartilhar-um-dashboard-com-quem-nao-tem-login-1cujfym/)

<!-- groner-suporte:veja-tambem:fim -->