LinkedIn PDF Carousels

Turn multiple images or documents into a scrollable PDF carousel in a single LinkedIn post. Perfect for presentations, portfolios, and multi-page documents.

Overview

Include type: "photo" and set details.type: "document" to bundle your media into a PDF carousel. You may upload images, PDFs, Word, or PowerPoint files up to 100 pages/photos.

Request Structure

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "linkedin": {
            "type": "photo",
            "text": "Description",
            "media": [
              {
                "id": "680fa5cc48487c4ccbf8c146",
                "name": "",
                "caption": "Photo by KaLisa Veer on Unsplash:\n\nhttps://unsplash.com/photos/the-chrysler-building-is-framed-by-other-buildings-sdU2K71G8TI",
                "path": "https://publer-dev.s3.amazonaws.com/uploads/photos/680fa5cc48487c4ccbf8c146.jpg",
                "type": "photo",
                "thumbnail": "https://publer-dev.s3.amazonaws.com/uploads/photos/thumb_680fa5cc48487c4ccbf8c146.jpg"
              },
              {
                "id": "66f54e664e299e991eaafaeb",
                "name": "pexels-christian-heitz-285904-842711.jpg",
                "caption": null,
                "path": "https://publer-dev.s3.amazonaws.com/uploads/photos/66f54e664e299e991eaafaeb.jpg",
                "type": "photo",
                "thumbnail": "https://publer-dev.s3.amazonaws.com/uploads/photos/thumb_66f54e664e299e991eaafaeb.jpg"
              },
              {
                "id": "66f122324e299eb6bcc9af55",
                "name": "",
                "caption": "Photo by David Villasana on Unsplash:\n\nhttps://unsplash.com/photos/a-black-car-parked-in-front-of-a-white-building-Pf9KhOIylaM",
                "path": "https://publer-dev.s3.amazonaws.com/uploads/photos/66f122324e299eb6bcc9af55.jpg",
                "type": "photo",
                "thumbnail": "https://publer-dev.s3.amazonaws.com/uploads/photos/thumb_66f122324e299eb6bcc9af55.jpg"
              },
              {
                "id": "66df7c954e299e47dae172ac",
                "name": "Cabin life",
                "caption": "Photo by Karsten Winegeart on Unsplash:\n\nhttps://unsplash.com/photos/a-house-sitting-on-top-of-a-lush-green-hillside-xUyOWyCjJ_I",
                "path": "https://publer-dev.s3.amazonaws.com/uploads/photos/66df7c954e299e47dae172ac.jpg",
                "type": "photo",
                "thumbnail": "https://publer-dev.s3.amazonaws.com/uploads/photos/thumb_66df7c954e299e47dae172ac.jpg"
              },
              {
                "id": "66df7c8d4e299e47dae172ab",
                "name": "",
                "caption": "Photo by Edgar.infocus on Unsplash:\n\nhttps://unsplash.com/photos/a-car-driving-on-a-foggy-road-AwRcfU8T4dg",
                "path": "https://publer-dev.s3.amazonaws.com/uploads/photos/66df7c8d4e299e47dae172ab.jpg",
                "type": "photo",
                "thumbnail": "https://publer-dev.s3.amazonaws.com/uploads/photos/thumb_66df7c8d4e299e47dae172ab.jpg"
              },
              {
                "id": "66d04c6d4e299e51d9e1f747",
                "name": "5574042b224543ecaf6989f6725dd555.jpeg",
                "caption": null,
                "path": "https://publer-dev.s3.amazonaws.com/uploads/photos/66d04c6d4e299e51d9e1f747.jpeg",
                "type": "photo",
                "thumbnail": "https://publer-dev.s3.amazonaws.com/uploads/photos/thumb_66d04c6d4e299e51d9e1f747.jpeg"
              }
            ],
            "details": {
              "type": "document"
            },
            "title": "Title of the document"
          }
        },
        "accounts": [
          {
            "id": "64c90c0d4e299e38dc86a284",
            "scheduled_at": "2025-06-21T14:16+02:00"
          }
        ]
      }
    ]
  }
}

Parameters

Field
Type
Description

networks.linkedin.type

string

Must be "photo"

networks.linkedin.text

string

Post caption (optional)

networks.linkedin.media[]

array

Up to 100 items; each with "id" from Media Upload

networks.linkedin.details.type

string

Must be "document" to enable PDF carousel

networks.linkedin.title

string

Document title (required)

accounts[].id

string

LinkedIn profile or page account ID

accounts[].scheduled_at

string

ISO 8601 timestamp for scheduling (omit to publish immediately)

Supported Features & Limitations

Feature
Details

Max Items

100 photos/pages

Supported Formats

JPEG, PNG, PDF, DOCX, PPTX

Media Mix

No GIFs or videos—photos/documents only

Title Requirement

title field is mandatory

File Size

No explicit size limit for photos; follows Media API rules

Editing

Cannot change media type after scheduling

Workflow

  1. Upload Media Use the Media Upload API to upload images or documents and collect their IDs.

  2. Compose Post

    • Set type: "photo", add media IDs.

    • Under details, set "type": "document".

    • Provide a title.

  3. Schedule or Publish

    • Add scheduled_at under accounts to schedule.

    • Omit scheduled_at to publish immediately.

Best Practices

  • Use high-resolution images or properly formatted documents for clarity.

  • Craft a concise title that accurately represents the carousel content.

  • Organize slides in logical order to guide viewers.

Last updated

Was this helpful?