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

# Widgets

> Interactive screens — dashboards, forms, calculators — your agents build on request, without you writing a single line of code.

A **Widget** is a visual, interactive mini-app built by an agent: a metrics dashboard, a registration form, a calculator, a filterable list. You ask in plain language and get a screen ready to use, share, and reuse.

<Frame caption="📸 Screenshot to add: the Widgets page (lanes per agent, Netflix-style).">
  <img src="https://mintcdn.com/iteam/E1mg8rFlXblsaNT0/images/placeholder.svg?fit=max&auto=format&n=E1mg8rFlXblsaNT0&q=85&s=36c435f4df28c31a7e114586a931bbd2" alt="Widgets page" width="800" height="420" data-path="images/placeholder.svg" />
</Frame>

## How to create a widget

In **Chat with Agents**, ask naturally:

> "Create a widget with revenue for the last 30 days, with total and a chart by day."

The agent builds the screen, connects to your data, and opens the widget in a side panel. Want to tweak it? Keep chatting:

> "Add a filter by state" · "Make it a bar chart" · "Switch the color to the brand green".

<Tip>
  Editing is safe: the agent **adjusts the existing widget** instead of rebuilding from scratch. You don't lose what was already good.
</Tip>

## Where to find your widgets

Click **Widgets** in the menu (right under *iTeam Assistant*). They're organized **by agent**, like channels — easy to find. The ones from the agents you use most appear first.

* **Hover** over a widget to see a **live preview**.
* **Click** to open it right in the agent's chat, with the widget already open.
* The **Preview** button opens a large centered window to look at it calmly.

<Frame caption="📸 Screenshot to add: widget preview in a centered modal.">
  <img src="https://mintcdn.com/iteam/E1mg8rFlXblsaNT0/images/placeholder.svg?fit=max&auto=format&n=E1mg8rFlXblsaNT0&q=85&s=36c435f4df28c31a7e114586a931bbd2" alt="Widget preview" width="800" height="420" data-path="images/placeholder.svg" />
</Frame>

## Widget types

<CardGroup cols={2}>
  <Card title="Dashboard" icon="chart-pie">
    KPIs, charts, and tables with a period filter. Ideal for tracking the business.
  </Card>

  <Card title="Form" icon="clipboard-list">
    Registrations and data collection, with automatic validation.
  </Card>

  <Card title="CRUD / List" icon="table">
    Lists with search, pagination, and actions (create, edit, delete).
  </Card>

  <Card title="Custom" icon="wand-sparkles">
    Calculators, internal tools, whatever your operation needs.
  </Card>
</CardGroup>

## Share securely

Each widget has a **visibility** level you control:

| Visibility  | Who can access                                                |
| ----------- | ------------------------------------------------------------- |
| **Private** | Only people with explicit access to the agent.                |
| **Company** | Anyone logged in from your company.                           |
| **Public**  | Anyone with the link (with optional **password protection**). |

<Info>
  Widgets respect the same access control as agents: someone without access to the agent **won't see** its widgets. [Understand access control →](/en/administration/security-and-access)
</Info>

## Why it's a differentiator

* **No development.** What used to be a ticket for IT becomes a 1-minute conversation.
* **Always live.** Widget data refreshes on its own — it's not a static image.
* **Reusable.** Build once, use always; share with the team via link.

## Next steps

<CardGroup cols={2}>
  <Card title="Chat with Agents" icon="messages-square" href="/en/chat/chat-with-agents">
    Where widgets are born.
  </Card>

  <Card title="Data Sources" icon="database" href="/en/resources/data-sources">
    Connect your data to power the dashboards.
  </Card>
</CardGroup>
