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

# Gerenciar widgets

> Adicione, configure e organize widgets — os cartões de consultas salvas que compõem um Report.

Um **widget** é uma única [consulta AftersellQL](/pt/aftersell/reports_explorer#writing-aql-queries) salva, renderizada como uma visualização em um relatório. Um relatório é simplesmente uma grade de widgets.

<Note>
  Um "widget" aqui significa um widget em um Report. Não é o mesmo que os [widgets de checkout](/pt/aftersell/checkout_widget_types) ou os [widgets de pós-compra](/pt/aftersell/post_purchase_widgets) voltados ao comprador, que são ofertas de upsell exibidas aos seus clientes.
</Note>

***

<div id="adding-a-widget">
  ## Adicionando um widget
</div>

Há duas formas de adicionar um widget a um relatório:

* **Arraste um widget existente da barra lateral Widgets.** Enquanto edita um relatório (clique em **Edit report** — veja [Gerenciar relatórios](/pt/aftersell/reports_dashboards)), arraste um widget já criado da barra lateral **Widgets** para o canvas.
* **Clique em Add widget no relatório.** Na visualização principal do relatório, clique em **Add widget** para criar uma nova consulta no Explorer e adicioná-la ao relatório. Depois de salvo, seu widget será adicionado diretamente ao canvas do Report.

***

<div id="visualizations">
  ## Visualizações
</div>

Dependendo do formato da consulta, um widget é renderizado como um dos seguintes:

* **Scorecard** — um único número de destaque, para consultas sem detalhamento.
* **Gráfico de linhas** — uma tendência ao longo do tempo.
* **Gráfico de área** — uma tendência ao longo do tempo com a área abaixo da linha preenchida.
* **Gráfico de barras** — uma comparação entre valores de uma dimensão.
* **Gráfico de funil** — queda ao longo dos posicionamentos ou de uma sequência de métricas.
* **Tabela** — linhas de valores, para consultas detalhadas ou com várias dimensões.

O Explorer recomenda uma visualização padrão para cada consulta, e o widget a utiliza.

***

<div id="exporting-a-widget">
  ## Exportando um widget
</div>

Cada widget tem um botão **Export to CSV** que baixa os dados atuais do widget como um arquivo `.csv`. Isso exporta o resultado da consulta subjacente — os mesmos números mostrados no gráfico ou tabela do widget — para que você possa trabalhar com eles em uma planilha.

***

<div id="arranging-widgets">
  ## Organizando widgets
</div>

No modo de edição, você pode arrastar widgets para reordená-los e redimensioná-los na grade. Quando terminar, clique em **Save** para manter o layout ou em **Cancel** para descartar as alterações.

***

<div id="deleting-a-widget">
  ## Excluindo um widget
</div>

Você pode excluir permanentemente um widget salvo a partir do Explorer. Excluir um widget também o remove de todos os relatórios em que ele aparece.

Para excluir um widget:

1. Abra o relatório em que o widget está.
2. Clique no cartão do widget. Isso o abre no **Explorer**.
3. Clique em **Delete** na barra de título do Explorer.
4. Confirme a exclusão na caixa de diálogo exibida.

<Note>
  O Explorer não tem uma lista de widgets salvos para escolher — um widget só é aberto clicando no seu cartão em um relatório. As linhas da barra lateral **Widgets** do modo de edição são alças de arraste para posicionar widgets e não podem ser clicadas para abrir um.
</Note>

O widget é removido permanentemente e todos os cartões de relatório que faziam referência a ele são limpos automaticamente.

<Note>
  O botão **Delete** só é exibido para widgets criados por você. Widgets de modelo globais são somente leitura e não podem ser excluídos.
</Note>

***

<div id="need-help">
  ## Precisa de ajuda?
</div>

Se você tiver dúvidas sobre widgets, fale com a equipe de suporte ao cliente.