Skip to content
UGC API

Instagram carousels: size, dimensions and how to make one

A carousel is one Instagram post with several photos or videos that people swipe through. Carousels get saved and re-shown more than single photos, because Instagram can show the next slide to someone who scrolled past the first one. This guide covers sizes, the slide limit, video slides, making one in the app, and what changes when you post through the API.

Updated

A carousel post holds up to 20 photos or videos in one post, with dots under the first slide showing there's more. It has one caption and one set of likes and comments. On the grid it shows the first slide. In the feed, Instagram can show a later slide to someone who didn't engage with the first, which gives a carousel a second chance a single image doesn't get.

ShapePixelsRatioUse
Portrait (tall)1080 × 14403:4Matches the profile grid since 2025; posted in the app
Portrait1080 × 13504:5The safest tall size: works in the app and through the API
Square1080 × 10801:1Simple, crops nothing
Landscape1080 × 5661.91:1Rarely a good idea on a phone
The first slide sets the shape for every slide. If the first is 4:5, a square second slide gets cropped or padded to 4:5. Make all slides the same size.

File limits: JPEG or PNG in the app (the API wants JPEG), up to 8 MB per image. Video slides are MP4 or MOV, up to 60 seconds each.

3:4 or 4:5?

Instagram switched the profile grid to 3:4 tiles in 2025, and the app now accepts 3:4 posts. If you post from the app, 1080 × 1440 fills the grid tile exactly. If you post through the Instagram API (or any scheduler built on it), the API only accepts images between 4:5 and 1.91:1, so a 3:4 image is rejected with an aspect ratio error. Use 1080 × 1350 if a post might go through an API. UGC API pads or crops images to fit automatically (fit: "pad" by default) and tells you; see Instagram API aspect ratio error.

  1. Tap + and choose Post.
  2. Tap the select multiple icon (stacked squares) and pick up to 20 photos or videos, in order.
  3. Pick the crop on the first one; it applies to all.
  4. Tap Next, add filters or edit each slide, then Next again.
  5. Write the caption, tag people or add collaborators, add music if you want, and Share.

Video slides and sound in carousels

Carousels can mix photos and videos. In the app you can add a song to a carousel. Through the API you can't add a song to a carousel, but video slides play with their own sound, so a carousel with one or more video slides is the way to get sound into an API-posted carousel. UGC API lets a slideshow mix images and short videos (3 to 60 seconds) and keeps the videos as video slides in the Instagram carousel.

CarouselReel
Reach to non-followersSome, through Explore and feed re-showsMost; Reels are recommended to non-followers by default
Saves and sharesHigh for tips, lists, guidesHigh for entertainment
EffortLow: images and textHigher: video editing
SoundApp music, or video slides' own audioAny audio

You don't always have to choose. UGC API can send the same slides as a carousel to one account and as a Reel to another (instagram.as_reel: true), with the slides rendered into a 1080×1920 video with music. Post both and compare in the campaign report.

Posting carousels through the API

The Instagram content publishing API builds a carousel in three steps: one container per slide with is_carousel_item=true, a CAROUSEL container listing the children, then media_publish. Video children have to finish processing before the parent can be created. UGC API does all of that from one request:

bash
curl https://ugcapi.dev/v1/posts \
  -H "Authorization: Bearer ugc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "accounts": ["acc_ig_main"],
    "format": "slideshow",
    "media": [
      "https://cdn.example.com/c/1.png",
      "https://cdn.example.com/c/2-demo.mp4",
      "https://cdn.example.com/c/3.jpg"
    ],
    "caption": "3 ways to use it (save this)",
    "options": { "instagram": { "alt_text": ["Product on a desk", "Demo video", "Before and after"] } }
  }'

PNG and WebP become JPEG, the shapes are fixed to one ratio, and the caption is trimmed to 2,200 characters and 30 hashtags. See post to an Instagram carousel and Story.

  • A first slide that makes people swipe: a promise, a number, or a question.
  • Large text on every slide; most people read carousels without tapping into them.
  • A last slide that asks for a save or share, since saves are what carousels are good at.
  • 5 to 10 slides. Twenty is the limit, not a target.

FAQ

How many slides can an Instagram carousel have?

Up to 20 photos or videos, in the app and through the API.

What is the best Instagram carousel size?

1080 × 1350 (4:5) works everywhere. 1080 × 1440 (3:4) fits the new grid but is rejected by the API.

Can carousel slides be different sizes?

No. The first slide sets the shape and the rest are cropped or padded to match.

Can I add music to a carousel?

In the app, yes. Through the API, no song can be attached, but video slides keep their own sound.

Related