> For the complete documentation index, see [llms.txt](https://docs.omnichat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnichat.ai/en/features/marketing/chatbot-2.0/carousel-card.md).

# Carousel Card

Supported Platforms: Webchat, Facebook, Instagram, LINE

With Carousel Card, you can create an interactive experience by displaying multiple images in a swipeable format.

It also offers customization options, such as buttons, links, and tags, to better engage customers and enhance their journey.

<div align="center"><figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F77sRp4uIpUh7yoHaTmMo%2F%E8%BC%AA%E6%92%AD%E8%A8%8A%E6%81%AF%E8%8B%B12.png?alt=media&amp;token=ab30746d-dfd9-4180-bdf6-43d75c049552" alt="" width="375"><figcaption><p>Carousel Card</p></figcaption></figure></div>

Carousel Messages = Text Card + Photo Card.

You can rearrange the cards by dragging them and add up to 10 cards.

This card consists of 5 editable sections:

1. [Upload Image](#upload-image)
2. [Actions Upon Clicking the Image](#actions-upon-clicking-the-image)
3. [Title and Description](#title-and-description)
4. [Add Button](#add-button)
5. [Add Carousel Message Card](#add-carousel-message-card)

{% hint style="warning" %}
To save a carousel message, you must complete 3 required settings:

1. Upload an image
2. enter a title
3. set up one button.
   {% endhint %}

#### 1. Upload Image

Images must be in .jpg, .jpeg, or .png format and up to 10 MB.

Recommended Dimensions:

* Rectangular: Supports a 1.91:1 image ratio.

| Platform                           | Recommended Image Size                                                            |
| ---------------------------------- | --------------------------------------------------------------------------------- |
| Webchat                            | 955 × 500 pixels                                                                  |
| Facebook, Instagram                | 955 × 500 pixels                                                                  |
| LINE                               | 755\*500 pixels                                                                   |
| Webchat, Facebook, Instagram, LINE | <ul><li>LINE: 755\*500 pixels</li><li>Other platforms: 955 × 500 pixels</li></ul> |

* Square:
  * Supports a 1:1 image ratio.
  * Recommended size: 955 × 955 pixels.

#### 2. Actions Upon Clicking the Image

<div align="left"><figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FzzxjMSqojZRVrD24k9XW%2Fcarousel%20Actions%20Upon%20Clicking%20the%20Image.png?alt=media&amp;token=ffee5626-06fd-4df6-b87b-b19992930e65" alt="" width="273"><figcaption><p>Actions Upon Clicking the Image</p></figcaption></figure></div>

This is an optional setup section with 2 available actions:

* **Click to open URL:** When a customer clicks the image, it will redirect to the specified website.
* **Additional Actions:** When a customer clicks the image, it will add the preset tag to the customer automatically.

{% hint style="success" %}

#### Sharing Chatbot Messages with LINE Friends

You can now use Chatbot 2.0 to set up actions that allow customers to share chatbot messages with their LINE friends.\
This feature is **only available on LINE platform** and is **only supported in Chatbot 2.0**.

<img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FuT4pLsarqFhzkllHErOx%2Fshare%20with%20line%20friends.png?alt=media&amp;token=eae56925-aedc-4637-97c2-2b632eaa4798" alt="" data-size="original">

**Supported Card and Button Types**

You can set up "Share with LINE Friends" action on the following card types and buttons:

* **Text Card**
  * Regular button (including Live Agent Card)
* **Carousel Card**
  * Image click action
  * Regular button
* **Image Carousel Message Card**
  * Image click action
  * Regular button

**Restrictions**

1. Only the following card types can be used in a shared block:
   * Text Card
   * Image Card
   * Video Card
   * Carousel Card
   * Image Carousel Message Card
   * LINE Rich Menu
2. Button Restrictions for Shared Blocks:
   * Only **URL-based actions** are allowed for buttons, such as:
     * Open URL
     * Share with LINE Friends
   * Using other action types will trigger an error.
   * If the block includes a LINE Rich Menu, it can't use a transparent background.
     {% endhint %}

#### 3. Title and Description

* **Title:** This is a required setup section, and each platform allows up to 80 characters (with each Chinese character counting as one). Emojis are also supported in the bottom right corner.

<div align="center"><figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FfaGvJ4HJo9myVPVmb0Cd%2Fcarousel%20title%20emoji.png?alt=media&amp;token=1a27b7a6-8869-4283-a82f-6f680a9eecb6" alt="" width="253"><figcaption><p>Title</p></figcaption></figure></div>

* **Description:**
  * This is an optional set up section, and emojis are also supported in the bottom right corner.
  * Variables are supported on all platforms except Webchat. But since multi-platform include Webchat, variables are not supported in that case either.
  * Description character count limits are as follows:

| Plarform                           | Maximum Character Limit |
| ---------------------------------- | ----------------------- |
| Webchat                            | 120 characters          |
| Facebook, Instagram                | 80 characters           |
| LINE                               | 300 characters          |
| Webchat, Facebook, Instagram, LINE | 80 characters           |

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fu4sbodb2X71NIQd8chMu%2Fdescription.png?alt=media&amp;token=886e9aa3-753e-4091-89a2-2dbc0d5d587e" alt="" width="242"><figcaption><p>Description</p></figcaption></figure>

{% hint style="warning" %}
The following two scenarios may cause the title and description to be partially hidden on Facebook:

1. Due to differences in screen sizes across devices, even if the description contains fewer than 80 characters, the full text may not always be displayed on Facebook. This means that what customers actually see may be shorter than what you set in the Omnichat console.
2. If the title is too long, it may also cut off part of the description.

🌟 To view the full text and see how the card is displayed to customers, please check Meta's Facebook chat console on a desktop.
{% endhint %}

#### 4. Add Button

* Each card must have at least 1 button.
* On the **LINE platform**, you can add up to 40 buttons, and it's best to use the same number of buttons on all cards. On other platforms, you can add up to 3 buttons.
* Button names can have up to 20 characters. When clicking the button, it will trigger the following actions:

<div align="left"><figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F7BMovXvtpaQJWTZy0btW%2FScreenshot%202025-03-22%20at%2012.09.50%E2%80%AFAM.png?alt=media&amp;token=8439762c-8232-47ac-9a6f-3c55970ab6ff" alt="" width="375"><figcaption></figcaption></figure></div>

1. **Actions Upon Clicking**
   1. **Reply Block:** Clicking the button will take customers to the designated card.
   2. **Open URL:**
      1. When a customer clicks the button, it will redirect to the specified URL.
      2. When editing a URL, you can change variables by clicking the lower right corner icon, but please note that this feature is not supported in Webchat.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FzZsiLfoqxAoH3kosHSvw%2Fparameters.png?alt=media&amp;token=357ee7a3-36cd-4920-bbdc-212cc184bcfc" alt="" width="375"><figcaption><p>Changing Variables</p></figcaption></figure>

{% hint style="success" %}
**Share chatbot messages with LINE friends**

You can now set up an action in Chatbot 2.0 that allows customers to share chatbot messages with their LINE friends. This feature is only supported on LINE platform and is available exclusively in Chatbot 2.0.

<img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FAG50Gc1Rdd77ui9q0uxu%2Fshare%20with%20friends.png?alt=media&amp;token=3a2abb43-7a36-47e7-a02a-be308e3e9483" alt="" data-size="original">

**Supported card and button types**

* Text Card (including human agent card)
  * Button
* Carousel Card
  * Action upon Clicking the Image
  * Button
* Image Carousel Card
  * Action upon Clicking the Image
  * Button

**Limitations**

* Only the following card types can be shared with others:
  * Text Card
  * Image Card
  * Carousel Card
  * Image Carousel Card
  * Image Map (Action can not be a Video Message)
  * Video Card
* Buttons on shared cards:
  * Only URL-type actions are allowed, such as opening a URL or sharing to LINE friends.
  * If you use other types of actions, an error will show.
  * If the block includes a LINE Rich Menu, transparent backgrounds are not allowed.
    {% endhint %}

2. **Additional Actions**
   1. **Add Tag:** When the customer clicks the button, it will add the preset tag to the customer automatically.
   2. **Save as Custom Attribute:**
      1. When the customer clicks the button, it will add the preset custom attribute to the customer automatically.
      2. Before using this feature, make sure to add attribute data on the Custom Attributes [page](https://console.omnichat.ai/custom-attribute). For instructions, please click [here](https://en-docs.omnichat.ai/features/social-cdp/custom-attribute-cdp-subscription-plan-only#custom-attributes-overview-page).

#### 5. Add Carousel Message Card

Scroll right to add carousel message cards, up to a maximum of 10 message card.

#### Below is an example of how a Carousel Card displays to customers on each platform:

Card setup:

<div align="left"><figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F4ZYWQfdkT2g2k9FcUxES%2Fcard%20setting.png?alt=media&amp;token=111a1e78-5d56-460e-92df-0070d465acb6" alt="" width="563"><figcaption><p>Carousel Card</p></figcaption></figure></div>

How the card displays on each platform:

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FfYoUZ9VtWv1LrYdox2Dh%2Fdisplay.png?alt=media&amp;token=6333bbb1-7196-4a03-8ba0-83a92c7cb914" alt=""><figcaption></figcaption></figure>