Custom widgets
How to get a widget that doesn't exist yet — have the agent build one for your library, or contribute a built-in widget to VizChat.
If the built-in widgets don't cover what you need, you can get a custom one. A custom widget is first-class: it carries its own data and configuration, the agent can drive it, and it is reusable across documents.
Have the agent build it
Describe what you want in the chat and the agent builds the widget and publishes it to your private library. This covers the vast majority of cases:
- Team-specific visualizations (an OKR card, a product SKU view)
- Small tools — timers, calculators, checklists, pickers
- Visualizations outside the standard set, or components embedding a third-party library
Widgets built this way are private to you by default, and can be published to the Marketplace.
Contribute a built-in widget
Built-in widgets live in the VizChat repository and ship to everyone. Choose this only when the widget is genuinely general-purpose and you intend to contribute it upstream — it requires a local development environment.
Develop locally and publish with the CLI
If you'd rather build on your own machine with your own toolchain, the vizchat-widget CLI lets you develop, preview, and publish a widget to the Marketplace without cloning the VizChat repo. See Publish a widget from the command line.
See the custom widget guide for all three paths in detail.
Which one?
| You want to | Pick |
|---|---|
| Something for your own work, right now | Have the agent build it |
| Something your team reuses | Have the agent build it, then publish to the Marketplace |
| Something shipped with VizChat for all users | Contribute a built-in widget |
| Your own toolchain, publishing to the Marketplace | Develop locally and publish with the CLI |
Next step
- Custom widget guide — all three paths end to end
- Widget concept
- Built-in widget types — check what already ships before building