# Card Container Action

This operation will add a new card in a carousel template. Each card can have text, an image, multiple buttons and a default URL.

![](/files/-Lg2njDEpydKfQeLqX6p)

### Settings

The action uses the following settings:

| Setting                   | Description                                                                                                                                                                                                                                                                                                                  | [Parsed](/actions-and-operations/dynamic-parsing.md) |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| Title                     | The title of the card.                                                                                                                                                                                                                                                                                                       | :white\_check\_mark:                                 |
| Subtitle                  | The subtitle of the card.                                                                                                                                                                                                                                                                                                    | :white\_check\_mark:                                 |
| Web View Height Ratio     | These options change the height of the Web View used to display web content when using an [Url Button](/actions-and-operations/cards/additional-buttons/xenioo.bots.actions.base.operations.buttonurloperation.md). This is a [Facebook ](https://developers.facebook.com/docs/messenger-platform/webview/)specific setting. | :white\_check\_mark:                                 |
| Default Url               | The default Url that will be opened by the card when clicked                                                                                                                                                                                                                                                                 | :white\_check\_mark:                                 |
| Image Source              | The Url or Xenioo storage source of the card main image. External image Urls need to be served through HTTPS protocol.                                                                                                                                                                                                       | :no\_entry:                                          |
| Use Messenger Extensions  | Enables the [Facebook messenger extension](https://developers.facebook.com/docs/messenger-platform/webview/extensions/) feature. When enabled the Default Url value must be part of the [whitelisted domains](/basic-concepts/publishing/channels/facebook.md#whitelisted-domains).                                          | :no\_entry:                                          |
| Redirect To Floating Area | If enabled and supported, the link will be displayed inside the channel floating area. Currently only [Web Channel](/basic-concepts/publishing/channels/web.md) supports the floating area.                                                                                                                                  | :no\_entry:                                          |

### Remarks

Not all channels can natively display carousels. Xenioo will resort to alternate rendering methods if the selected channel does not support carousels natively.

{% embed url="<https://www.youtube.com/watch?v=MSFPls2DyPc>" %}

When used on a touch enabled device, carousel cards can be scrolled using a simple swipe gesture.

#### RCS Media Size

When using a single or carouse card on RCS, Xenioo will assign the media height based on the View Height Ratio value, following the table below. Please be aware that Meta TALL is actually a medium size while FULL is actually the TALL size for RCS.

| Height Ratio | Media Height |
| ------------ | ------------ |
| COMPACT      | SHORT        |
| TALL         | MEDIUM       |
| FULL         | TALL         |

### Trigger

This action has no triggers.

### Variables

This action does not produce any variable.

### Availability

Channel specific availability follows the table below:

| Channel          | Availability     |
| ---------------- | ---------------- |
| Facebook         | Fully Available. |
| WhatsApp         | Fully Available. |
| Telegram         | Fully Available. |
| Web              | Fully Available. |
| Alexa            | Fully Available. |
| Google Assistant | Fully Available. |
| Slack            | Fully Available. |
| API              | Fully Available. |

This action can be used only inside interactions and not as child of other actions. Any account can use this action regardless of [subscription level](/basic-concepts/your-account/the-free-plan.md).

### Further Reading

{% embed url="<https://www.xenioo.com/en/using-button-groups-cards-carousel/>" %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xenioo.com/actions-and-operations/cards/xenioo.bots.actions.base.operations.elementoperation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
