> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Create Carousel Ad
> Create Meta carousel ads with 2-10 cards containing images or videos in bulk mode
The **Create Carousel Ad** node lets you create professional carousel ads for Facebook and Instagram campaigns. Carousel ads showcase multiple images or videos in a single ad, allowing users to swipe through different cards. This node only supports bulk creation using Google Sheets templates.
***
## When to Use It
* Showcase multiple products in a single ad
* Tell a story across multiple cards
* Highlight different features of a single product
* Create interactive shopping experiences
* Display before/after sequences
* Show step-by-step tutorials or processes
* Increase engagement with swipeable content
* Test different creative combinations within one ad
***
## Inputs
| Field | Type | Required | Description |
| ------------------- | -------------- | -------- | ----------------------------------------------------- |
| **Account** | Select | Yes | Select a Meta Ads account |
| **Page** | Dynamic-select | Yes | Select Facebook page for the ads |
| **Structured Data** | Dynamic-text | Yes | Google Sheets data containing carousel ad information |
### Bulk Upload Template
For carousel ad creation, use the [Google Sheets template](https://docs.google.com/spreadsheets/d/1yAE2JDqxLFGCyHjjIQsvxn240B-ekg0B3eqcsssMQOQ/edit?gid=70412443#gid=70412443) with these columns:
#### Required Columns
| Column | Description | Required |
| ----------------------- | ------------------------------------------------- | -------- |
| **adset\_id** | Ad set ID where the carousel ad will be created | Yes |
| **ad\_name** | Name for the carousel ad | Yes |
| **ad\_status** | ACTIVE or PAUSED (recommended: PAUSED for review) | Yes |
| **primary\_text** | Main ad copy that appears above the carousel | Yes |
| **website\_url** | Default landing page URL for all cards | Yes |
| **card\_1\_media\_url** | Image or video URL for the first card | Yes |
| **card\_1\_headline** | Headline text for the first card | Yes |
| **card\_2\_media\_url** | Image or video URL for the second card | Yes |
| **card\_2\_headline** | Headline text for the second card | Yes |
#### Optional Columns
| Column | Description | Usage |
| ------------------------------ | ---------------------------------------------------------------- | -------- |
| **card\_N\_description** | Description text for card N (where N = 1-10) | Optional |
| **card\_N\_website\_url** | Specific landing URL for card N (overrides default website\_url) | Optional |
| **card\_N\_call\_to\_action** | Call-to-action button for card N (e.g., SHOP\_NOW, LEARN\_MORE) | Optional |
| **card\_N\_story\_media\_url** | Dedicated media for Stories placement for card N | Optional |
| **form\_id** | Lead form ID for lead generation carousel ads | Optional |
#### Additional Cards (3-10)
For cards 3 through 10, you can add:
* **card\_N\_media\_url** and **card\_N\_headline** (both required if any card\_N field is provided)
* Any of the optional columns listed above
**Important**: If you provide ANY field for a card (3-10), then both `card_N_media_url` AND `card_N_headline` become required for that card.
***
## Card Requirements
### Media Specifications
**Images:**
* **File type**: JPG or PNG
* **Aspect ratio**: 1:1 (square) recommended for best display
* **Recommended resolution**: 1080 x 1080 pixels
* **Maximum file size**: 30 MB
* **Minimum resolution**: 600 x 600 pixels
**Videos:**
* **File type**: MP4, MOV, or GIF
* **Aspect ratio**: 1:1 (square) or 4:5 (vertical)
* **Maximum file size**: 4 GB
* **Maximum duration**: 240 minutes
* **Recommended duration**: 15 seconds or less for optimal performance
* **Video thumbnails**: Auto-generated by Meta
### Content Guidelines
**Card Limits:**
* **Minimum**: 2 cards per carousel
* **Maximum**: 10 cards per carousel
* **Optimal**: 3-5 cards for best performance
**Text Requirements:**
* **Primary text**: 125 characters or less for optimal display
* **Card headlines**: 25 characters or less for maximum visibility
* **Card descriptions**: 20 characters or less when used
***
## Output
Returns the created carousel ad IDs and count:
```json theme={"dark"}
{
"ad_ids": ["120210543987640123", "120210543987640124"],
"created_count": 2
}
```
* `ad_ids`: Array of all successfully created carousel ad IDs
* `created_count`: Total number of carousel ads created
***
## Credit Cost
* **Cost per run**: 3 credits per carousel ad created
* **Example**: 5 carousel ads = 15 credits
***
## FAQs
**Carousel Ads:**
* Show 2-10 images or videos in one ad
* Users can swipe through cards
* Each card can have its own headline, description, and landing URL
* Higher engagement rates due to interactive nature
* Better for showcasing multiple products or telling stories
**Single Image Ads:**
* Display one image per ad
* Simpler setup and management
* Better for single product focus
* Lower file size requirements
Yes! Each card in a carousel can be either an image or video. You can mix different media types within the same carousel ad.
**Best practices:**
* Keep media styles consistent (similar filters, lighting, etc.)
* Ensure videos are short (under 15 seconds) for better performance
* Use square aspect ratio (1:1) for both images and videos
* Video thumbnails are automatically generated by Meta
**Strategic card ordering:**
1. **Lead with your strongest visual** - Put your most compelling image/video first
2. **Tell a story** - Arrange cards in logical sequence (problem → solution, before → after)
3. **Product showcase** - Start with hero product, then show variations or details
4. **Call-to-action progression** - Build interest through early cards, strong CTA on final cards
**Performance tip**: Meta automatically optimizes card order based on performance, but starting with strong content helps initial delivery.
Yes! You can set different landing URLs for each card using the `card_N_website_url` columns in your template.
**Use cases:**
* Link each product card to its specific product page
* Direct users to different category pages
* Send traffic to relevant blog posts or resources
* A/B test different landing pages within one ad
**Fallback**: If you don't specify a card-specific URL, it will use the default `website_url` from your template.
Popular CTA options for carousel ads:
**E-commerce:**
* **SHOP\_NOW** - Direct purchasing intent
* **VIEW\_MORE** - Product browsing
* **GET\_OFFER** - Promotional campaigns
**Lead Generation:**
* **LEARN\_MORE** - Information gathering
* **SIGN\_UP** - Newsletter or service signup
* **CONTACT\_US** - Direct inquiry
**Content/Apps:**
* **DOWNLOAD** - App installs
* **WATCH\_MORE** - Video content
* **READ\_MORE** - Blog articles
**Pro tip**: Different cards can have different CTAs. Match the CTA to the specific content of each card for better performance.
Use the `card_N_story_media_url` columns to provide optimized media for Stories placements:
**Stories Optimization:**
* **Aspect ratio**: 9:16 (vertical)
* **Resolution**: 1080 x 1920 pixels
* **Content**: Full-screen, mobile-first design
**When to use:**
* Your default 1:1 cards don't display well in Stories
* You want Stories-specific messaging or design
* Different product angles work better vertically
**Example setup:**
```
card_1_media_url: "square-product-shot.jpg" (1:1)
card_1_story_media_url: "vertical-product-shot.jpg" (9:16)
```
Meta will automatically choose the best media for each placement.
Yes! Carousel ads work excellently for lead generation:
**Setup for lead forms:**
1. Add your `form_id` column in the template
2. Use lead-friendly CTAs like SIGN\_UP or LEARN\_MORE
3. Each card can highlight different benefits
4. Final card should have the strongest conversion message
**Best practices:**
* Use first cards to build interest and trust
* Show multiple value propositions across cards
* Include social proof or testimonials
* Keep form fields minimal for higher conversion rates
**Creative Best Practices:**
* **Consistent branding** across all cards
* **High-quality visuals** with good lighting and composition
* **Clear headlines** that complement the visuals
* **Logical flow** between cards (tell a story)
* **Strong first card** to capture attention
**Technical Optimization:**
* Use 1:1 aspect ratio for universal compatibility
* Keep file sizes optimized for fast loading
* Test both images and videos
* Include 3-5 cards for optimal engagement
**Content Strategy:**
* Show different product angles or use cases
* Highlight key features across multiple cards
* Use the last card for strong call-to-action
* A/B test different card arrangements
**Meta Ads Manager provides detailed carousel insights:**
1. **Card-level metrics** - See performance for each individual card
2. **Click-through rates** - Which cards drive the most clicks
3. **Engagement data** - Swipe behavior and time spent per card
4. **Conversion tracking** - Which cards lead to actual conversions
**Optimization tips:**
* Pause or replace underperforming cards
* Promote high-performing cards to the first position
* Use insights to inform future carousel creative strategy
* Test different headlines and descriptions based on data
**Limited editing options:**
* You cannot add/remove cards from existing carousel ads
* You cannot change the media in existing cards
* You can edit text elements (headline, description, primary text)
* You can change the landing URLs
**For major changes:**
* Create a new carousel ad with updated content
* Pause the old ad and activate the new one
* Use A/B testing to compare performance
**Pro tip**: Always review your carousel ads carefully before setting them to ACTIVE status.
**Simple Google Drive setup:**
1. **Upload your images** to Google Drive
2. **Right-click** on each image file
3. **Select "Share"** → "Anyone with the link" (Viewer permissions)
4. **Copy the link** and paste directly into your template
**Example of what to paste:**
```
https://drive.google.com/file/d/11j-rCp9wgrV44y4G33emLY-VVcLFlSgN/view?usp=sharing
```
**For carousel media:**
* Organize images in a dedicated Google Drive folder
* Use consistent naming (product-1-square.jpg, product-1-story.jpg)
* Ensure all images have proper sharing permissions
* Test a few links before bulk uploading
**No conversion needed** - Markifact automatically handles Google Drive URL processing.