social-media-image-sizes
Image sizes for 14 platforms: 55 sizes with safe zones, upload limits and minimum sizes, plus specs for 6 passport and visa photos. As JSON, an npm package, an agent skill and an MCP server. Data under CC BY 4.0.
Website · JSON · 中文说明
Most size lists stop at width × height. When you crop, you also need to know what the app puts on top of your image: the profile picture over a YouTube banner, the caption bar at the bottom of a Story, the 3:4 profile grid that trims a 4:5 Instagram post. This dataset has those areas in pixels.
Quick look
One size per row. Each group has more sizes in the data.
| Platform | Image | Size (px) | Ratio | Crop on CropDen |
|---|
| Instagram | 3:4 portrait post (+3 more) | 1080 × 1440 | 3:4 | Crop |
| Instagram | Story (+2 more) | 1080 × 1920 | 9:16 | Crop |
| Instagram | Profile picture (+1 more) | 320 × 320 | 1:1 | Crop |
| YouTube | Channel banner (+1 more) | 2560 × 1440 | 16:9 | Crop |
| YouTube | Video thumbnail (4K) (+2 more) | 3840 × 2160 | 16:9 | Crop |
| YouTube | Short (9:16) (+1 more) | 1080 × 1920 | 9:16 | Crop |
| Facebook | Cover photo (+2 more) | 851 × 315 | 2.70:1 | Crop |
| Facebook | Feed post (4:5) (+3 more) | 1080 × 1350 | 4:5 | Crop |
| Discord | Profile banner (+3 more) | 600 × 240 | 5:2 | Crop |
| Discord | Custom emoji (+2 more) | 128 × 128 | 1:1 | Crop |
| LinkedIn | Profile background (+3 more) | 1584 × 396 | 4:1 | Crop |
| X (Twitter) | Header photo (+3 more) | 1500 × 500 | 3:1 | Crop |
| Twitch | Profile banner (+3 more) | 1200 × 480 | 5:2 | Crop |
| TikTok | Video / photo slide (+2 more) | 1080 × 1920 | 9:16 | Crop |
| Pinterest | Standard pin (2:3) (+2 more) | 1000 × 1500 | 2:3 | Crop |
| Snapchat | Story / Spotlight | 1080 × 1920 | 9:16 | Crop |
| Etsy | Listing photo (4:3) (+2 more) | 3000 × 2250 | 4:3 | Crop |
| Shopify | Product image | 2048 × 2048 | 1:1 | Crop |
| eBay | Listing photo | 1600 × 1600 | 1:1 | Crop |
| Amazon | Main product image | 2000 × 2000 | 1:1 | Crop |
Passport photos (make one on CropDen):
| Document | Pixels | Print size |
|---|
| US passport & visa | 600 × 600 | 50.8 × 50.8 mm |
| UK passport | 600 × 771 | 35 × 45 mm |
| EU / Schengen | 600 × 771 | 35 × 45 mm |
| Canada | 600 × 840 | 50 × 70 mm |
| Australia | 600 × 771 | 35 × 45 mm |
| China visa | 600 × 873 | 33 × 48 mm |
All sizes and their zones are in data/social-media-image-sizes.json. To crop an image to any of them in your browser, follow the link in the last column.
Use it
npm
npm install social-media-image-sizes
import { getSize, groups } from 'social-media-image-sizes';
const post = getSize('instagram-post/portrait-34');
// { width: 1080, height: 1440, ratio: '3:4', exact: true, ... }
const youtube = groups.filter((g) => g.platform === 'YouTube');
CommonJS works too: const { getSize } = require('social-media-image-sizes').
JSON over HTTP
const res = await fetch('https://cropden.com/data/social-media-image-sizes.json');
const { groups, passportPhotos } = await res.json();
The endpoint allows cross-origin requests and is cached for an hour.
Use it with AI agents
Skill: make images in the right size
skills/social-media-image-sizes is an Agent Skill for Claude Code, Codex, Cursor and other agents that read SKILL.md. Ask "turn this photo into a YouTube banner" or "what size is an Instagram story?". It picks the size, crops the image on your machine with sharp, keeps the file under the upload limit, and draws a preview with the covered areas in red.
npx skills add geektao1024/social-media-image-sizes
Or copy the folder into ~/.claude/skills/ (Claude Code) or your agent's skills folder.
MCP server: sizes plus AI image tools
CropDen runs a remote MCP server at https://cropden.com/mcp (Streamable HTTP).
This is the beginning of the README. Read the rest at the original. Read the full README ↗
