itch.io image sizes and image checker
The itch.io cover image needs a 315:250 ratio: 315x250 at least, and itch.io suggests larger, such as 630x500. Screenshots can be any size. itch.io gives no size for the banner or background. The table quotes itch.io's docs for each image, and the checker tests your file in your browser.
| Image | Size | GIF | Notes |
|---|---|---|---|
| Cover image Game listings across itch.io: browse, search, collections and the front page. | 315:250 ratio. 315x250 minimum, larger is better, such as 630x500. | Yes. itch.io asks that an animated cover has no seizure-inducing effects. | Needed to be indexed in search and browse. itch.io does not say how it crops a cover of another shape. |
| Screenshots The right column of a two column page, and other parts of the site. | Any size. 3 to 5 screenshots recommended. | Yes. "Just like cover images, screenshots can also be GIFs." | A single column page hides the screenshot column. itch.io still recommends screenshots for browser games. |
| Banner (header image) Top of the project page, set in the theme editor. It replaces the title above the description. | No size given. The page column is 960 pixels wide by default (Custom CSS guide). | Yes, an animated GIF. A semi-transparent PNG also works. | itch.io calls it probably the most important graphic on the page. |
| Background image Behind the whole project page, set in the theme editor. | No size given. | Not stated. | itch.io shows a page that uses a background repeating from top to bottom to style the column. |
| HTML5 embed background Behind the Play button of a browser game that uses Click to play, set in the theme editor. | No size given. It fills the game viewport, whose size you set in Embed options. | Not stated. | With "Click to launch in fullscreen" you give no viewport size. |
| Embed widget Other websites, through the iframe code from the Widgets panel. | No upload. The demo embed code on the widget page is 552x167. | Not stated. | The widget reuses the images and text of your project page. It has light and dark styles. |
| Game jam cover image The jam page and itch.io promotion of jams. | No size given. | Not stated. | itch.io lists a cover image among the fields to fill in if a jam wants to be eligible for promotion. |
What itch.io says, word for word
- Cover image: "Cover images should respect a 315:250 aspect ratio. 315x250 is a minimum, but it’s best to include a larger image with the same aspect ratio, like 630x500." (itch.io docs: Getting started (creators))
- Screenshots: "Screenshots can be any size, it’s recommended to upload between 3 and 5 of them." (itch.io docs: Getting started (creators))
- Banner (header image): "It can be a semi-transparent PNG, it could be an animated GIF" (itch.io docs: Designing your page)
- Background image: "The background is more subtle, but it can achieve cool effects" (itch.io docs: Designing your page)
- HTML5 embed background: "A image that takes up the size of the viewport that sits behind the Play button." (itch.io docs: Uploading HTML5 games)
- Embed widget: "It pulls images and description text from the information you've set on the project edit page." (itch.io docs: The itch.io embeddable widget)
- Game jam cover image: "If you want to be eligible for promotion please make sure to fill out all the appropriate fields: description, summary, cover image, etc." (itch.io docs: Hosting a game jam)
Not in itch.io's docs
- How a cover of another shape is cropped or scaled in listings.
- A size for the banner, the background image, the HTML5 embed background or a jam cover.
- A file size limit for images. The Creator FAQ says only that individual file size is limited and that the limit can be raised by request.
- A list of accepted image file types. The docs name PNG and GIF, but give no full list.
Check an image
How to use it
- Find the image in the table: the size itch.io gives, whether it can be a GIF, and where itch.io shows it.
- Under "Check an image", pick the slot in "Image slot".
- Choose your file in "Image file". It stays on your device.
- Read the size, ratio, file type and file size checks.
- For a cover, look at the crop preview: it shows what a centred crop to 315:250 keeps, and the largest exact cover size your image can give.
How it works
Each row of the table rests on one sentence from itch.io's own docs, quoted under the table with its page. We read every page on 2026-11-19. Where itch.io gives no number, the table says "No size given" and the checker passes any size: we do not invent one.
The browser opens your file locally and reads its width, height, file size and first bytes, which give the real file type and whether a GIF is animated. For a cover, the ratio passes when it is within 1% of 315:250 (our tolerance), the size must be at least 315x250, and a third check asks for 630x500 or more, as itch.io suggests.
itch.io does not say how it fits a cover of another shape. The crop preview scales the image to fill the ratio and cuts the overflow evenly on both sides, the same cover crop our Steam capsule resizer uses. It shows what a crop would cost, not what itch.io does.
ratio difference = |width ÷ height - 315 ÷ 250| ÷ (315 ÷ 250)
scale = max(315 ÷ width, 250 ÷ height); kept width = 315 ÷ scale; kept height = 250 ÷ scale
largest exact cover = the largest multiple of 63x50 that fits in the kept part (315:250 is 63:50 in lowest terms)Worked example
Example with made-up inputs: a 1920x1080 screenshot used as a cover
The ratio check fails: "Size 1920x1080 (16:9). itch.io asks for a 315:250 ratio. This image is 41% off, so see the crop preview below." The minimum and the suggested size pass, because 1920x1080 is larger than 630x500 on both sides.
Crop preview: scale = max(315 ÷ 1920, 250 ÷ 1080) = max(0.1641, 0.2315) = 0.2315. The kept part is 315 ÷ 0.2315 = 1361 pixels wide and the full 1080 tall, so the crop cuts 29% of the width, 280 pixels from each side. The largest exact cover from the kept part is 1323x1050.
A 630x500 PNG passes all 5 checks.
How to read the result
A failed ratio check means your cover is not 315:250. Crop it yourself before you upload, so you choose what stays in the frame. Use the crop preview to see what a centred crop would cut.
A failed minimum or suggested size check means the cover is small. Export it again from your source art at 630x500 or a larger multiple of 63x50.
For the banner, background and embed background, every size passes, because itch.io gives none. Our practice: open the page in the theme editor and look at it on a wide screen and on a phone.
What itch.io does not document
itch.io's docs give no crop rule for a cover of another shape, no size for the banner, background, embed background or jam cover, no image file size limit and no list of accepted image types. The Creator FAQ says only that individual file size is limited and can be raised by request. The widget page shows a 552x167 demo embed, which is a frame size, not an upload size.
The cover decides if people click
itch.io calls the cover typically the first thing people see on its browse pages, and a project needs one to be indexed in search and browse. Screenshots matter too: itch.io recommends 3 to 5 and shows them in other parts of the site, even for browser games.
Limits
The checker reads size, file type and file size only. It cannot read text in an image, judge the art, or test an animated GIF for flashes. itch.io asks that animated covers have no seizure-inducing effects, so check that by eye.
itch.io gives no image file size limit, no list of accepted types and no size for most slots. The checker shows these values but does not fail them, except the file type, which fails outside PNG, JPG and GIF (our practice).
The crop preview is our centred crop, not itch.io's own. The table follows itch.io's docs as we read them; itch.io can change them, so check the page editor if an upload is refused.
Frequently asked questions
What size is the itch.io cover image?
itch.io asks for a 315:250 aspect ratio. 315x250 pixels is the minimum, and itch.io says it is best to upload a larger image with the same ratio, such as 630x500. Any multiple of 63x50 keeps the ratio exact, for example 945x750 or 1260x1000.
What size should an itch.io banner be?
itch.io gives no banner size. Its docs say the banner can be a semi-transparent PNG or an animated GIF, and that it replaces the title above the description. The custom CSS guide says the page column is 960 pixels wide by default, which is a useful width to design for, but it is not a rule from itch.io.
Can my itch.io cover or screenshots be GIFs?
Yes. itch.io's quality guidelines say you can upload a GIF of your project as the cover image, and that screenshots can also be GIFs. For an animated cover, itch.io asks that it has no seizure-inducing effects, following the Web Content Accessibility Guidelines. The checker tells you when a GIF is animated.
What happens if my cover is not 315:250?
itch.io's docs do not say how a cover of another shape is cropped or scaled. To stay in control, crop it to 315:250 before you upload. The crop preview in this tool shows what a centred crop keeps, and the largest exact cover size your image can give, so you can export it from your art tool.
How many screenshots should I upload to itch.io?
itch.io recommends 3 to 5 screenshots, and says they can be any size. A two column page shows them in the right column next to your trailer. A single column page hides them, but itch.io still shows them in other parts of the site, so upload them for browser games too.
Is my image uploaded anywhere?
No. The checker opens your image in your browser and reads its size, type and first bytes there. The crop preview is drawn on your device too. Nothing is sent to our servers, and you do not need an account, so you can check unreleased art safely. Reload the page to clear the image.
Sources
- itch.io docs: Getting started (creators), read
- itch.io docs: Quality guidelines, read
- itch.io docs: Designing your page, read
- itch.io docs: Custom CSS guide, read
- itch.io docs: Uploading HTML5 games, read
- itch.io docs: The itch.io embeddable widget, read
- itch.io docs: Creator FAQ, read
- itch.io docs: Getting indexed in search and browse, read
- itch.io docs: Hosting a game jam, read
Last reviewed . All math runs in your browser. We do not send your inputs anywhere.
Next step
After you change your cover, see which channels bring buyers. Manalens imports itch.io views, downloads and payments per day, and can record purchases for the players who made them, matched by an email your server sends. Track an itch.io game →