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

# Shopify widget elements

> Enable Shopify-specific elements in the chat widget, such as product carousels and order detail cards.

Shopify widget elements let your AI Agent show Shopify information visually inside the chat widget.

You can enable:

* **Product carousel**: show Shopify products as product cards.
* **Order details**: show order status and order details in a card.

<Info>
  Available on: **Starter, Advanced, Business, and Enterprise**.\
  Shopify widget elements require **Shopify Actions**. Free plans do not include Actions.
</Info>

<Info>
  Shopify widget elements are only available for the **chat widget**. They are not available for other channels.
</Info>

## Before you start

Before enabling Shopify widget elements, make sure:

* Shopify is connected to your Watermelon agent. [This article](https://app.mintlify.com/watermelon/watermelon/editor/main/~/7361d629-22e7-44ae-a131-4ce5471c31ad) explains how.
* The chat widget is connected to the same agent where Shopify is connected.
* The right Shopify Actions are enabled for your agent.
* You have access to the chat widget settings in Watermelon.

Shopify widget elements appear when your agent uses Shopify results in a conversation. They do not appear for every message.

## Available Shopify widget elements

### 1. Product carousel

The product carousel shows Shopify products as product cards in the chat widget.

Customers can browse products directly inside the conversation. Depending on your settings, product cards can include prices and links to the product page.

<Card title="Best for">
  Helping customers discover products, compare options, and continue browsing in your Shopify store.
</Card>

**Required Shopify Action:** Retrieve and display products

#### Setup instructions

<Steps>
  <Step title="Go to Integrations">
    In Watermelon, go to **Integrations**.

    <Frame>
      <img src="https://mintcdn.com/watermelon/wJQ56kFbVOdnqxl9/images/shopify-widget-elements-1.png?fit=max&auto=format&n=wJQ56kFbVOdnqxl9&q=85&s=fbbda7dbbdedbdc974ebb1ec9358af20" alt="Shopify Widget Elements 1" width="1439" height="778" data-path="images/shopify-widget-elements-1.png" />
    </Frame>
  </Step>

  <Step title="Select Chat Widget">
    Select the **Chat Widget** integration from the integrations overview.
  </Step>

  <Step title="Choose the connected chat widget">
    Select the chat widget that is connected to your Shopify agent.

    Make sure this is the same agent where Shopify is connected.

    <Frame>
      <img src="https://mintcdn.com/watermelon/wJQ56kFbVOdnqxl9/images/shopify-widget-elements-2-1.png?fit=max&auto=format&n=wJQ56kFbVOdnqxl9&q=85&s=018d561b76a37b129ad8ca62a7b7bf43" alt="Shopify Widget Elements 2 1" width="1439" height="778" data-path="images/shopify-widget-elements-2-1.png" />
    </Frame>
  </Step>

  <Step title="Select Attract">
    In the chat widget settings, go to **Attract**.

    <Frame>
      <img src="https://mintcdn.com/watermelon/wJQ56kFbVOdnqxl9/images/shopify-widget-elements-3.png?fit=max&auto=format&n=wJQ56kFbVOdnqxl9&q=85&s=2206174fae2644c73357c7cf110c5bf4" alt="Shopify Widget Elements 3" width="1439" height="778" data-path="images/shopify-widget-elements-3.png" />
    </Frame>
  </Step>

  <Step title="Find the Product carousel setting">
    Scroll down until you find the **Product carousel** setting.

    <Frame>
      <img src="https://mintcdn.com/watermelon/wJQ56kFbVOdnqxl9/images/shopify-widget-elements-4-carousel.png?fit=max&auto=format&n=wJQ56kFbVOdnqxl9&q=85&s=4b99dcc8206e8c11c415b621652d312a" alt="Shopify Widget Elements 4 Carousel" width="1439" height="778" data-path="images/shopify-widget-elements-4-carousel.png" />
    </Frame>
  </Step>

  <Step title="Enable the product carousel">
    Turn the product carousel **on**.
  </Step>

  <Step title="Configure the product carousel">
    Choose how products should appear in the chat widget.

    You can configure:

    * **Maximum products per response**: limits the number of product cards the AI Agent can show in one response. You can choose between **1 and 10**. The default is **3**.
    * **Show product prices**: choose whether product prices are shown in the carousel.
    * **Open product links in**: choose whether product links open in a **new tab** or the **same tab**.
          <Frame>
            <img src="https://mintcdn.com/watermelon/wJQ56kFbVOdnqxl9/images/shopify-widget-elements-4-carousel-1.png?fit=max&auto=format&n=wJQ56kFbVOdnqxl9&q=85&s=ea90798d774e9f34e911abf071c5252b" alt="Shopify Widget Elements 4 Carousel 1" width="1439" height="778" data-path="images/shopify-widget-elements-4-carousel-1.png" />
          </Frame>
  </Step>

  <Step title="Save your settings">
    Click **Save**.

    The product carousel is now enabled for the selected chat widget.
  </Step>
</Steps>

#### Test the product carousel

Test the chat widget that is connected to your Shopify agent.

Ask product-related questions, such as:

* “Can you show me your most popular products?”
* “Do you have black sneakers?”
* “Can you show me products under €50?”
* “Can you show me a few similar products?”

Check whether the agent shows product cards and whether the carousel settings match your preferences.

***

### 2. Order details

The order details element shows Shopify order information in a card inside the chat widget.

Customers can use this card to see the status of their order and details of what the order contains.

<Card title="Best for">
  Helping customers check order status and review what is included in their order.
</Card>

**Required Shopify Action:** Retrieve and display orders

#### Setup instructions

<Steps>
  <Step title="Go to Integrations">
    In Watermelon, go to **Integrations**.

    <Frame>
      <img src="https://mintcdn.com/watermelon/wJQ56kFbVOdnqxl9/images/shopify-widget-elements-1.png?fit=max&auto=format&n=wJQ56kFbVOdnqxl9&q=85&s=fbbda7dbbdedbdc974ebb1ec9358af20" alt="Shopify Widget Elements 1" width="1439" height="778" data-path="images/shopify-widget-elements-1.png" />
    </Frame>
  </Step>

  <Step title="Select Chat Widget">
    Select the **Chat Widget** integration from the integrations overview.
  </Step>

  <Step title="Choose the connected chat widget">
    Select the chat widget that is connected to your Shopify agent.

    Make sure this is the same agent where Shopify is connected.

    <Frame>
      <img src="https://mintcdn.com/watermelon/wJQ56kFbVOdnqxl9/images/shopify-widget-elements-2.png?fit=max&auto=format&n=wJQ56kFbVOdnqxl9&q=85&s=52fd4164e840566a9512a9e45253b061" alt="Shopify Widget Elements 2" width="1439" height="778" data-path="images/shopify-widget-elements-2.png" />
    </Frame>
  </Step>

  <Step title="Select Attract">
    In the chat widget settings, go to **Attract**.

    <Frame>
      <img src="https://mintcdn.com/watermelon/wJQ56kFbVOdnqxl9/images/shopify-widget-elements-3.png?fit=max&auto=format&n=wJQ56kFbVOdnqxl9&q=85&s=2206174fae2644c73357c7cf110c5bf4" alt="Shopify Widget Elements 3" width="1439" height="778" data-path="images/shopify-widget-elements-3.png" />
    </Frame>
  </Step>

  <Step title="Find the Order details setting">
    Scroll down until you find the **Order details** setting.

    <Frame>
      <img src="https://mintcdn.com/watermelon/wJQ56kFbVOdnqxl9/images/shopify-widget-elements-5-order.png?fit=max&auto=format&n=wJQ56kFbVOdnqxl9&q=85&s=8520aa396b2293de5621f8a92a62a4f9" alt="Shopify Widget Elements 5 Order" width="1439" height="778" data-path="images/shopify-widget-elements-5-order.png" />
    </Frame>
  </Step>

  <Step title="Enable order details">
    Turn order details **on**.

    When enabled, customers can see an order card in the chat widget with the order status and order details.
  </Step>

  <Step title="Save your settings">
    Click **Save**.

    Order details are now enabled for the selected chat widget.
  </Step>
</Steps>

#### Test order details

Test the chat widget that is connected to your Shopify agent.

Ask order-related questions, such as:

* “Where is my order?”
* “Can you show me the details of my order?”
* “What is the status of my latest order?”
* “Can you check order #1234?”

Check whether the agent shows an order card with the correct order status and order details.

<Info>
  The order card can only show information that is available in Shopify. The customer may need to provide enough order details for the AI Agent to find the right order.
</Info>
