> For the complete documentation index, see [llms.txt](https://publer.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://publer.com/docs/posting/create-posts/content-types/platform-specific-formats/multi-link-posts-facebook-carousels.md).

# Multi-Link Posts (Facebook Carousels)

Create and schedule multi‐link carousel posts on Facebook Pages. Carousels let you showcase up to 10 clickable cards—each with its own image, title, description, and call-to-action—in a single organic post.

### Request Body

```json
{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "facebook": {
            "type": "carousel",
            "text": "Explore our top features!",
            "sublinks": [
              {
                "url": "https://publer.com",
                "title": "Publer Dashboard",
                "description": "Manage all your social accounts in one place.",
                "images": [
                  "https://cdn.publer.com/images/dashboard1.jpg",
                  "https://cdn.publer.com/images/dashboard2.jpg"
                ],
                "default_image": 0,
                "call_to_action": "LEARN_MORE"
              },
              {
                "url": "https://publer.com/pricing",
                "title": "Pricing Plans",
                "description": "Find the right plan for your team.",
                "images": [
                  "https://cdn.publer.com/images/pricing.jpg"
                ],
                "default_image": 0,
                "call_to_action": "SIGN_UP"
              }
            ]
          }
        },
        "accounts": [
          {
            "id": "63c675b54e299e9cf2b667ea",
            "scheduled_at": "2025-07-06T23:18:00Z"
          }
        ]
      }
    ]
  }
}
```

### Parameters

#### networks.facebook

<table><thead><tr><th width="124.7813720703125">Field</th><th width="107.924560546875">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>type</code></td><td>string</td><td>Must be <code>"carousel"</code>.</td></tr><tr><td><code>text</code></td><td>string</td><td>Caption shown above the carousel cards.</td></tr><tr><td><code>sublinks[]</code></td><td>array</td><td>List of carousel items (max 10).</td></tr></tbody></table>

#### sublinks\[] Object

<table><thead><tr><th width="175.5565185546875">Field</th><th width="86.56463623046875">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>url</code></td><td>string</td><td>Target link for this card.</td></tr><tr><td><code>provider_display</code></td><td>string</td><td>(Optional) Display domain or provider name.</td></tr><tr><td><code>title</code></td><td>string</td><td>Card title (overrides fetched metadata).</td></tr><tr><td><code>description</code></td><td>string</td><td>Card description (overrides fetched metadata).</td></tr><tr><td><code>images</code></td><td>string[]</td><td>Array of image URLs for this card.</td></tr><tr><td><code>default_image</code></td><td>integer</td><td>Index (0-based) of the default image in <code>images</code>.</td></tr><tr><td><code>call_to_action</code></td><td>string</td><td>CTA button type: <code>NO_BUTTON</code>, <code>LEARN_MORE</code>, <code>SIGN_UP</code>, etc.</td></tr><tr><td><code>phone_number</code></td><td>string</td><td>(Optional) Phone number for call-to-action cards.</td></tr><tr><td><code>customized</code></td><td>boolean</td><td>(Optional) <code>true</code> if overriding the link’s default thumbnail or metadata.</td></tr></tbody></table>

### Key Notes & Limitations

* **Pages Only**: Supported on Facebook Pages. Group posts will include only the first sublink.
* **Max Sublinks**: Up to 10 cards per carousel.
* **No Cost**: Carousel posts are organic (no ad spend).
* **Syncing**: Published carousel posts can only sync back as regular link posts (no carousel structure).

### Workflow

1. **Select Page**\
   Choose a Facebook Page account in the `accounts` array.
2. **Define Sublinks**\
   Provide `url`, `title`, `description`, and `images` for each card.
3. **Arrange Order**\
   Order sublinks as they should appear (array index defines order).
4. **Schedule or Publish**
   * For scheduled: set `scheduled_at` under `accounts`.
   * For immediate: omit `scheduled_at` and use `/posts/schedule/publish`.

### Best Practices

* **Engaging Thumbnails**\
  Use high-quality images that clearly represent each link.
* **Clear Titles & Descriptions**\
  Keep text concise and action-oriented to drive clicks.
* **Focused Carousels**\
  Limit to 5–7 cards to avoid overwhelming users.
* **A/B Test CTAs**\
  Experiment with `LEARN_MORE`, `SIGN_UP`, and other button types.

### Related Topics

* [Platform-Specific Formats](/docs/posting/create-posts/content-types/platform-specific-formats.md)
* [Publishing Methods](/docs/posting/create-posts/publishing-methods.md)
* [Content Types](/docs/posting/create-posts/content-types.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://publer.com/docs/posting/create-posts/content-types/platform-specific-formats/multi-link-posts-facebook-carousels.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.