> For the complete documentation index, see [llms.txt](https://support.charlla.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.charlla.io/en/userguide/widget/create.md).

# Create a widget

### Create a widget

<figure><img src="https://1857767629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fo7CC5HKFh1guYnGcyftj%2Fuploads%2FkCnISGldxxBJBNA1bXQx%2Fcreate-1-en.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1857767629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fo7CC5HKFh1guYnGcyftj%2Fuploads%2F6Lzvu615EwqWR6kFMILn%2Fcreate-2-en.png?alt=media" alt=""><figcaption></figcaption></figure>

1. Go to **Widget** and click **\[+ Create New Widget]**.
2. Choose a widget layout and click **\[Select]**. You can see the selected widget type in the preview on the right.

<figure><img src="https://1857767629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fo7CC5HKFh1guYnGcyftj%2Fuploads%2F8AVoZmKAqlAoRAToDkwv%2Fcreate-3-en.png?alt=media" alt=""><figcaption></figcaption></figure>

3. In the **Add to Playback Order** dialog, select the videos to add to the widget. You can add up to 200 videos to a widget's playback order.
4. Click **\[Add]** to create the widget.

{% hint style="info" %}
Videos without a linked product banner don't appear in the widget.\
Every Charlla widget needs at least one short-form video with a linked product to go live.\
If a video has no linked product, click **\[+]** under **Linkable Products** to link one.
{% endhint %}

<figure><img src="https://1857767629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fo7CC5HKFh1guYnGcyftj%2Fuploads%2FcJJmcCd0xhOd0lOYAdrX%2Fcreate-4-en.jpg?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1857767629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fo7CC5HKFh1guYnGcyftj%2Fuploads%2FIcfa7kp1Nl7VdwrTAhCP%2Fcreate-5-en.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1857767629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fo7CC5HKFh1guYnGcyftj%2Fuploads%2FlPiDzmkEoKNO9kgc9fd0%2Fcreate-6-en.png?alt=media" alt=""><figcaption></figcaption></figure>

5. With the Slide widget, you can also build the widget from product items. You can add up to 200 videos and products in total.
6. If you have no products yet, click **\[+ Add New Product]** to add one.

<figure><img src="https://1857767629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fo7CC5HKFh1guYnGcyftj%2Fuploads%2Fd8wlNDLsm56GNmKmTkRo%2Fcreate-7-en.png?alt=media" alt=""><figcaption></figcaption></figure>

7. **Product Name** and **Product Page URL** are required when you add a product.
8. Enter the product details and click **\[Register]** to add the product. You can reuse it later and link it to other videos in your widgets.

<figure><img src="https://1857767629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fo7CC5HKFh1guYnGcyftj%2Fuploads%2FPWQjrgFgU49AfEcVk4Pt%2Fcreate-8-en.png?alt=media" alt=""><figcaption></figcaption></figure>

9. New products appear in the product list.
10. Select the products to add and click **\[Add]** to create the widget.

<figure><img src="https://1857767629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fo7CC5HKFh1guYnGcyftj%2Fuploads%2FpQavUStVWkTsQxa2l1mB%2Fcreate-9-en.png?alt=media" alt=""><figcaption></figcaption></figure>

1. With the Slide widget, you can also build the widget from product items. You can add up to 200 videos and products in total.
2. Use the search box to find products by product name or product code.
3. To add another product, click **\[+ Add New Product]**.

{% hint style="info" %}
A Slide widget can't consist of product items only.\
It needs at least one short-form video with a linked product banner to go live.
{% endhint %}

### Widget editor

<figure><img src="https://1857767629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fo7CC5HKFh1guYnGcyftj%2Fuploads%2F5KTIeYSKHljKR8QTfwzq%2Fcreate-10-en.jpg?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1857767629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fo7CC5HKFh1guYnGcyftj%2Fuploads%2Frv1Tntg7qNm6nRd6rRVY%2Fcreate-11-en.jpg?alt=media" alt=""><figcaption></figcaption></figure>

1. The title of your widget. Click it to edit.
2. Click **\[Preview]** to open the widget at its actual size in a new window.
3. Click **\[Copy Link]** to copy the widget's link.
4. Click **\[Copy Code]** to copy the widget's code. Paste the code where you want the widget to appear.
5. Click **\[More]** to delete the widget.

### Widget list

<figure><img src="https://1857767629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fo7CC5HKFh1guYnGcyftj%2Fuploads%2FsYn18rraapBbsmP69Esi%2Fcreate-12-en.png?alt=media" alt=""><figcaption></figcaption></figure>

1. See how many widgets you have of each type.
2. Filter the list by widget type.
3. Click **\[Create New Widget]** to create a new widget.
4. Search widgets by widget title, creator, video title, or product name.
5. Sort widgets by newest or oldest first.
6. Each widget card shows the number of items, the widget title, the creator, and the creation date. The card thumbnail shows the videos or product images in the widget.
7. Hover over a widget card to copy its link or code, duplicate it, or delete it.


---

# 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://support.charlla.io/en/userguide/widget/create.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.
