0xDocs 0x.limo

Docs / Store page

Store art and media

Capsule, screenshot and trailer formats and sizes for a 0x store listing, how the store crops them, and the share images.

#Capsule

The capsule is the game's main image. It is used on store cards, the game page, the launcher library and share previews.

FormatPNG only (the CLI refuses other files; the API checks the PNG signature)
File size≤ 1 MiB
Aspect616:353 (about 1.75:1). Store cards show it at this ratio.
Recommended size616×353 (as in the examples) or 1232×706 for sharp high-DPI cards
MinimumUnder 460×215 gets a pre-check warning
RequiredOn the first version. Later versions keep it if you leave it out.

The pre-check also warns when the capsule is mostly transparent (90% or more) or nearly one color. These are warnings only: the reviewer still sees the game and can approve it.

Note

The submission form's label says "920×430 or larger", and the pre-check message mentions 920×430 too. The store's cards use 616:353, so art at 920×430 (2.14:1) is cropped. Make it 616:353.

To render store art from your game, give it a fixed scene behind a query parameter (the examples use ?art=capsule) and screenshot it at 616×353 in a headless browser.

#Screenshots

FormatPNG or JPEG
CountUp to 6
File size≤ 2 MiB each
Aspect16:9. The game page media strip shows them at 16:9, cropped to fill.
Recommended size1280×720 or 1920×1080

Sending screenshots replaces the whole set. Leaving it out keeps the last version's screenshots.

#Trailer

A trailer plays first in the game page's media strip. You can provide either:

  • a link to YouTube (youtube.com/watch?v=, youtu.be/, …) or Vimeo. YouTube plays from youtube-nocookie.com;
  • a file, MP4 or WebM of at most 60 MB. Upload it first, then name it in the submission:
bash
curl -s -X PUT https://api.0x.limo/v1/listings/uploads/trailer \
  -H "authorization: Bearer $ZEROX_TOKEN" --data-binary @trailer.webm
# {"upload": "<name>.webm", "bytes": …, "type": "video/webm", "note": "name it in your submission: …"}
json
{ "listing": { "trailer": { "upload": "<name>.webm" } } }

An approved version's trailer file is served with byte ranges from /v1/listings/<id>/media/<version>/<file>. "trailer": false removes the trailer, and leaving the key out keeps it.

#Share images

Game pages (0x.limo/game/<id>) carry Open Graph and X card tags. The image is your capsule. If you have none, the store generates a 1200×630 card from your game's name, tagline and accent color (/og/game/<id>.png). See Embeds for X player cards and oEmbed.