> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Dynamic Images
> Learn how to generate and automate personalized images per contact with dynamic text, avatar, and QR code layers in ChatbotX.
**Dynamic Images** allows you to design custom graphic templates that automatically merge personalized contact information (social media profile picture, name, phone number, loyalty points, or unique QR code) into a final image before sending it via chatbot conversations.
This feature is ideal for issuing VIP membership cards, event tickets, personalized discount vouchers, birthday greetings, or order delivery confirmations across Messenger, Instagram, and WhatsApp.
Automatically insert the recipient's Facebook, Instagram, or WhatsApp profile photo into your canvas.
Populate names, order numbers, balance points, or any custom contact fields dynamically.
Generate unique QR codes containing custom URLs or contact IDs with your brand logo in the center.
## Create a new Dynamic Image
From the left sidebar in ChatbotX, go to **Tools** and select the **Dynamic Images** card.
On the Dynamic Images manager page, click the **+ Create Dynamic Image** button in the upper-right corner.
In the editor view, configure the initial template settings:
* **Name**: Enter a descriptive name for your template (for example, `VipCard` or `EventTicket`).
* **Custom Field (optional)**: Select a Custom Field if you want ChatbotX to automatically save the generated image URL into the contact's profile.
* **Width & Height**: Set the canvas width and height in pixels (for example, `500` x `320`).
If you want to quickly start from a pre-designed layout, click the blue **Template** link below the Name field.
The **Choose a template** modal displays pre-built graphic cards (such as gold VIP cards, event passes, or gift certificate frames). Selecting a template applies its background and styling to your canvas.
Selecting a template replaces all current layers on your canvas.
Click the **+ Add element** button to add layers to your canvas:
* **Add image**: Add static background graphics, contact avatars, or images from Custom Fields.
* **Add text**: Add dynamic text layers with personalized contact attributes.
* **Add QR code**: Add a dynamic QR code layer.
You can drag and position elements directly on the canvas or reorder them in the **Layers** list on the left.
Once your design is ready, click **Save** in the bottom-right corner. The system provides a **Public URL** for automating image delivery in your chat flows.
## Configure layer elements
### Image Element
When selecting an Image layer in the Layers panel, you can choose from three data sources under **Image type**:
#### Image URL (Static image from URL or upload)
Use this option for static card backgrounds, badge graphics, decorative frames, or company logos. You can paste a direct image link into the **Image URL** field or click **Upload image** to upload a file from your computer.
Configurable options include dimensions (**Width**, **Height**), frame shape (**Square** or **Circle**), and a **Priority** toggle to bring this layer to the front.
#### Contact avatar (Recipient profile picture)
Automatically fetches the recipient's live profile avatar from the connected messaging channel (Facebook Messenger, Instagram, or WhatsApp).
You can specify custom dimensions (for example, `80` x `80` px) and set the **Image style** to **Circle** for a clean circular avatar.
#### Custom field (Dynamic image from contact attribute)
Reads a dynamic image URL stored in a contact's custom attribute (for example, a previously uploaded portrait photo, digital signature, or certificate).
Select the target Custom Field from the **Custom field (optional)** dropdown.
### Text Element
Text layers display static text combined with dynamic contact placeholders:
* **Text content**: Enter your text string. Click the `` code button to insert Custom Field variables (such as `{{first_name}}`, `{{phone}}`, `{{qrcode}}`) or the smiley icon to insert emojis.
* **Font size**: Font size in pixels.
* **Font family**: Select font family (Arial, Roboto, etc.).
* **Alignment**: Text alignment options (**Left**, **Center**, **Right**).
* **Color**: Select a color or enter a hex color code (e.g., `#000000`).
* **Text formatting**: Toggle switches for **Bold**, **Italic**, or **Uppercase**.
### QR Code Element
QR code layers generate scannable codes on the fly:
* **QR code content**: Enter the data to encode. This can be a static website link, voucher code, or dynamic variables like `{{user_id}}`.
* **Size**: Dimensions of the QR code in pixels.
* **Color**: Foreground color of the QR code dots.
* **Logo**: Click **Upload logo** to place your brand logo at the center of the QR code.
## Use Dynamic Images in Chatbot Workflows
After saving your template, ChatbotX generates a **Public URL** with the following format:
```text theme={null}
https://app.chatconnectx.com/dynamic-images?dynamicImageId=[IMAGE_ID]&userId={{user_id}}
```
The `userId={{user_id}}` parameter ensures that whenever the message is delivered, ChatbotX dynamically resolves the recipient's user ID and renders their personalized graphic in real time.
### Send via Flow Builder message blocks
You can deliver personalized graphics in your automated flows using two methods: pasting the direct **Public URL** or referencing a **Custom Field** attribute.
This capability is supported across all image-enabled message blocks:
* **Image**: Delivers the personalized graphic as a standalone image message.
* **Card**: Displays the graphic as a card banner along with a title, subtitle, and interactive buttons.
* **Carousel**: Embeds personalized graphics across multiple carousel slides.
#### Method 1: Paste the Public URL directly
Copy the **Public URL** from your Dynamic Image template configuration (which includes `userId={{user_id}}`) and paste it directly into the image URL field of an Image, Card, or Carousel block. When the message is sent, ChatbotX automatically detects the contact's `user_id` and renders the personalized image in real time.
#### Method 2: Use a Custom Field attribute
If you selected a Custom Field under **Custom Field (optional)** when creating your template (or stored the image URL in a contact attribute):
1. In the Image or Card block within Flow Builder, click the image URL input field.
2. Enter the attribute tag directly using `{{attribute_name}}` syntax (such as `{{vipcard}}`) or click the `` code icon on the right side of the input field to select your Custom Field.
3. When the flow executes, the system dynamically retrieves the image URL stored in that contact attribute and renders the corresponding image.
### Send via WhatsApp Template Messages
For outbound notifications outside the 24-hour window on WhatsApp, you can include Dynamic Images in pre-approved **Template Messages**:
Select or create a WhatsApp Template with a Media Header set to **Image**.
In the Header media URL field, paste the **Public URL** of your Dynamic Image.
Fill in the required body parameters (`{{1}}`, `{{2}}`...).
Preview the personalized image rendering directly inside the WhatsApp template preview card.
To learn more about creating and submitting templates for Meta approval, see the [WhatsApp Template Messages](/docs/channels/whatsapp/whatsapp-template-messages) guide.
## Practical Example: Automated VIP Card Distribution
Here is a common scenario for delivering personalized VIP cards:
Upload a gold card background (500 x 320 px). Add a **Contact avatar** image layer with **Circle** style on the left. Add a **Text** layer containing `{{first_name}}` formatted in bold uppercase. Add a **QR code** layer pointing to `https://example.com/vip?id={{user_id}}` with your company logo centered. Click **Save** and copy the **Public URL**.
Create a greeting or loyalty reward Flow. Add a **Send Image** or **Send Card** block and paste the Public URL into the Image URL field. Add call-to-action buttons below the card.
When a contact triggers the flow, ChatbotX instantly generates their personalized card featuring their own avatar, name, and QR code, delivering it straight to their inbox.
## Best Practices
* **Preserve the `{{user_id}}` parameter:** Always ensure `userId={{user_id}}` remains in the Public URL when pasting into Flows or WhatsApp Templates so the system can resolve contact attributes correctly.
* **Optimize background file sizes:** For static background images, use compressed PNG or JPG files under 1MB to ensure fast loading times.
* **Account for variable text lengths:** If dynamic text fields (like names) vary significantly in length, choose an appropriate font size and alignment to prevent text clipping.