> For the complete documentation index, see [llms.txt](https://docs.fastn.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fastn.ai/embed/widget-builder.md).

# Widget

Integrations, layout, style and features of the panel your customers see.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-a7792b48ea24985a2cb14c2f030ee6c59c026775%2Ffastn-lifecycle-2-publish.svg?alt=media" alt="Stage 2, Publish: the product owner adds integrations to the widget catalog and chooses what customers may change"><figcaption><p>Where this fits: stage 2 of the integration lifecycle</p></figcaption></figure>

**Embed → Widget**: the Layout, Style and Features tabs. The Embed tab has its [own page](https://docs.fastn.ai/embed/embedding.md).

Opening **Widget** takes you straight into the builder; there is no widget list page. The header badge reads **Live** when everything is saved and **Unsaved changes** while you have edits pending, and **Widget actions** ⋯ offers **Reset to defaults**. The sticky footer carries **Reset**, **Discard changes** (only while you have unsaved edits) and **Save and publish**.

{% hint style="warning" %}
**Reset** and **Reset to defaults** do the same thing: after you type `RESET` in the **Reset widget to defaults?** dialog, they publish the default configuration to every customer using the widget, immediately, and it cannot be undone. To drop edits you have not saved, use **Discard changes**.
{% endhint %}

## Integrations

Below the tabs, the **INTEGRATIONS** panel lists what appears in the widget, with a count. This panel *is* the widget list: the offer your customers browse. Everything else on this screen is presentation.

An integration that moves data between two systems shows both logos and a direction marker, such as `Dynamics 365 F&O → BigCommerce B2B outbound →`. A status dot marks each one **draft** or **active**.

### Add Integrations

**Add** opens the **Add Integrations** dialog, with two tabs:

| Tab         | What it offers                                               |
| ----------- | ------------------------------------------------------------ |
| **Apps**    | **Select connectors**: individual systems from your catalog. |
| **Unified** | Unified API categories rather than one connector at a time.  |

On the **Apps** tab, **Scope:** offers **Organization level** (the default, captioned "Shared connections") or **User level** ("Per-customer connections"). The choice is recorded on each integration you create (it sets the integration's sync direction and agent context); it does not share or separate connections. Which customer's connections an integration uses comes from the embed token the widget runs with.

### Edit Integration

The pencil on a row opens **Edit Integration**, where most of the configuration lives: the configuration template, activation mode, customer visibility, the connectors and their per-connector overrides, the workflows that auto-bind to every connected customer, triggers, and the callbacks that run a workflow when a customer activates or changes something.

It has a page of its own: [Edit Integration](https://docs.fastn.ai/embed/widget-builder/edit-integration.md).

### In this section

* [Edit Integration](https://docs.fastn.ai/embed/widget-builder/edit-integration.md)
* [Layout](https://docs.fastn.ai/embed/widget-builder/layout.md)
* [Style](https://docs.fastn.ai/embed/widget-builder/style.md)
* [Features](https://docs.fastn.ai/embed/widget-builder/features.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.fastn.ai/embed/widget-builder.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
