> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wanhap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Media

> Attach images, videos, and PDFs to your social media posts.

## Supported media types

| Type         | Common formats      |
| ------------ | ------------------- |
| **Image**    | JPG, PNG, GIF, WebP |
| **Video**    | MP4, MOV            |
| **Document** | PDF                 |

WebM is intentionally excluded — every major social platform rejects it, so accepting it would just produce platform-specific publish failures.

## Upload limits

| Type           | Default cap     |
| -------------- | --------------- |
| Image          | 10 MB per file  |
| Video          | 1 GB per file   |
| Document (PDF) | 100 MB per file |

Files over 1 MB are uploaded in chunks automatically so big videos transfer reliably even on flaky connections.

Signed upload links used by AI agents (via MCP) are single-use and expire after **15 minutes** by default.

## Platform content types and media requirements

Each platform supports different content formats with specific media requirements — this table is the reference.

There is **no** `linkedin_carousel`, `linkedin_page_carousel`, or `instagram_carousel` content type on posts. Multi-image Instagram posts use `instagram_feed`. LinkedIn multi-image / PDF posts use `linkedin_post` / `linkedin_page_post` (format is inferred from the attached media; optional `meta.document_title` for PDFs).

### LinkedIn / LinkedIn Page

| Content type                           | Media    | Max files                             | Notes                                                                             |
| -------------------------------------- | -------- | ------------------------------------- | --------------------------------------------------------------------------------- |
| `linkedin_post` / `linkedin_page_post` | Optional | Up to 10 images, or 1 video, or 1 PDF | Images/videos/documents cannot be mixed. PDF posts can set `meta.document_title`. |

### X (Twitter)

| Content type | Media    | Max files           | Notes                            |
| ------------ | -------- | ------------------- | -------------------------------- |
| `x_post`     | Optional | 4 images or 1 video | Images and video cannot be mixed |

### Facebook

| Content type     | Media    | Max files                  | Aspect | Notes                            |
| ---------------- | -------- | -------------------------- | ------ | -------------------------------- |
| `facebook_post`  | Optional | Up to 10 images or 1 video | —      | Standard page post               |
| `facebook_reel`  | Required | 1 video                    | 9:16   | Short-form vertical video        |
| `facebook_story` | Required | 1 video                    | 9:16   | Vertical video story (up to 60s) |

### Instagram (and Instagram via Facebook)

| Content type      | Media    | Max files                   | Aspect | Notes                                                              |
| ----------------- | -------- | --------------------------- | ------ | ------------------------------------------------------------------ |
| `instagram_feed`  | Required | Up to 10 images, or 1 video | 4:5    | Single- or multi-image feed post (carousel = multiple images here) |
| `instagram_reel`  | Required | 1 video                     | 9:16   | Short-form vertical video                                          |
| `instagram_story` | Required | 1 image or 1 video          | 9:16   | Disappears after 24 hours                                          |

### TikTok

| Content type   | Media    | Max files       | Aspect | Notes                                  |
| -------------- | -------- | --------------- | ------ | -------------------------------------- |
| `tiktok_video` | Required | 1 video         | 9:16   | Short or long-form video               |
| `tiktok_photo` | Required | Up to 35 images | 1:1    | Photo carousel — images only, no video |

### YouTube

| Content type    | Media    | Max files | Aspect | Notes                           |
| --------------- | -------- | --------- | ------ | ------------------------------- |
| `youtube_short` | Required | 1 video   | 9:16   | Vertical short, up to 3 minutes |

### Threads

| Content type   | Media    | Max files                  | Notes                         |
| -------------- | -------- | -------------------------- | ----------------------------- |
| `threads_post` | Optional | Up to 10 images or 1 video | Text post with optional media |

### Pinterest

| Content type          | Media    | Max files  | Aspect | Notes                     |
| --------------------- | -------- | ---------- | ------ | ------------------------- |
| `pinterest_pin`       | Required | 1 image    | 2:3    | Standard image pin        |
| `pinterest_video_pin` | Required | 1 video    | 9:16   | Video pin                 |
| `pinterest_carousel`  | Required | 2–5 images | 2:3    | Multi-image swipeable pin |

### Bluesky

| Content type   | Media    | Max files                 | Notes                         |
| -------------- | -------- | ------------------------- | ----------------------------- |
| `bluesky_post` | Optional | Up to 4 images or 1 video | Text post with optional media |

### Mastodon

| Content type    | Media    | Max files                 | Notes                         |
| --------------- | -------- | ------------------------- | ----------------------------- |
| `mastodon_post` | Optional | Up to 4 images or 1 video | Text post with optional media |

### Telegram

| Content type    | Media    | Max files              | Notes                                      |
| --------------- | -------- | ---------------------- | ------------------------------------------ |
| `telegram_post` | Optional | Up to 10 images/videos | Text post; multiple media sent as an album |

### Discord

| Content type      | Media    | Max files              | Notes                                              |
| ----------------- | -------- | ---------------------- | -------------------------------------------------- |
| `discord_message` | Optional | Up to 10 images/videos | Channel message; supports mentions and rich embeds |

## Media ordering

Drag attachments in the post editor to reorder them. The order you set is the order they'll appear on the social platform — important for carousels and multi-image posts.

## FAQ

<AccordionGroup>
  <Accordion title="What's the maximum file size?">
    **10 MB** per image, **1 GB** per video, **100 MB** per PDF.
  </Accordion>

  <Accordion title="Can I use the same media in multiple posts?">
    Each post stores its own media records. To reuse the same image, upload it again or copy from the asset library.
  </Accordion>

  <Accordion title="What happens to media when I delete a post?">
    The media records are removed along with the post.
  </Accordion>

  <Accordion title="Are images compressed or resized?">
    Wanhap uploads media to social platforms as-is. Each platform applies its own compression and resizing rules afterwards.
  </Accordion>
</AccordionGroup>
