CropDen: image sizes and AI image tools

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).

Tool	What it does	Cost
get_image_sizes	Sizes, safe zones and upload limits from this dataset	Free, no key
ai_extend_image	Extend an image to a wider or taller shape (outpainting)	5 credits
ai_upscale_image	Upscale 2x or 4x	8 or 12 credits
ai_remove_background	Transparent PNG	1 credit
get_ai_task, get_credit_balance	Check a long run, check your balance	Free, needs a key

Claude Code:

claude mcp add --transport http cropden https://cropden.com/mcp \
  --header "Authorization: Bearer YOUR_CROPDEN_API_KEY"

Other clients: add https://cropden.com/mcp as a Streamable HTTP server with the same header. Get a key at cropden.com under Settings → API keys. The AI tools use the same credits as the website, and a failed run is refunded. Without a key, only get_image_sizes works.

What's in an entry

Field	Meaning
id	<group>/<size>, e.g. youtube-banner/banner
width, height	Pixels to export
ratio	Aspect ratio, e.g. 3:4
exact	false means only the ratio matters
recommended	The size we'd pick when a group has several
minWidth, minHeight	Smallest upload the platform accepts or needs
maxBytes	Upload limit in bytes (1 MB = 1,000,000)
zones	Areas in pixels: safe-area (keep content inside), ui-overlay (covered by the app), crop-preview (what another view shows)
zones[].measured	Measured in the live app; the platform doesn't publish it
zones[].x, y, ...	Pixels from the top-left of the image. A zone can reach past the edge, like a profile picture that overlaps the bottom of a banner
note	One-line tip, in English and Chinese

Each group also has formats, facts (video length and similar), verified and a url to crop on CropDen. Passport photos add print size in millimetres and head and eye-line ranges as fractions of the photo height.

How the numbers are checked

• Platform help pages come first. Where a platform publishes nothing (Instagram profile pictures, for example), we use the size current guides agree on.
• Zones with measured: true were measured in the apps. Apps move their buttons around, so treat those as guides.
• verified is the month a group was last checked. Source links for every group are coming in 0.2.0.
• Found a size that's out of date? Open an issue with a link to the source.

If you only want values the platforms document themselves, use The Social Specification, which marks everything else as not documented. This dataset is made for cropping, so it fills those gaps with practical sizes and safe zones.

On the website

CropDen does the cropping. Pick a size, see the safe zones over your own image, and export at the exact pixel size and under the upload limit. The crop and resize tools run in your browser. The site also has batch resizing and AI tools: extend, upscale and remove background.

License

• Data (data/, and the same data in index.js and index.cjs): CC BY 4.0. Credit it like this: Image size data by CropDen (https://cropden.com), CC BY 4.0. On a website, the link is enough.
• Code: MIT.

Thanks

SammaPix (MIT) was our starting reference for which platforms and passport photos to cover, and we cross-checked sizes against its data files.

If this saved you a lookup, a star helps other people find it.

Built in public by Geektao (@geektao0319, posts in Chinese).