Restrictions on screenshots and videos in snap listings


Do a snap’s screenshots have, and if not should they have:

  • A maximum number? (We just tested uploading 18 screenshots, with no error. I’d suggest a maximum of 4 or 5, not counting banner graphics.)
  • Minimum dimensions? (The upload form seems to accept a 10 px × 10 px “screenshot”, which would be obviously a mistake.)
  • Maximum dimensions? (The upload form seems to accept a 10000 px × 6000 px “screenshot”. Any sufficiently large image is effectively a DoS for end users.)
  • A maximum file size?
  • Any restrictions on aspect ratio? (A “screenshot” that’s 3840 px × 100px might be within allowed dimensions, but it would look like a malfunction to store users.)
  • Any restrictions on animation? (That is, what happens if you try to upload an APNG?)

Separately, should it be possible to upload videos? Other stores allow this. If so, they should also be limited in number (I’d suggest 1), dimensions, duration, and file size.

These questions are important because they influence the UI for uploading and ordering. For example, the easiest UI for organizing screenshots is quite different if the maximum number is 4 than if it’s 30.


In the absence of any other input … here’s a straw-person proposal for screenshots:

  • Maximum number: 4
  • Minimum dimensions: 640 px × 640 px
  • Maximum dimensions: 4096 px × 2160 px (the biggest common 4K variant)
  • Maximum file size: 20 MB
  • Aspect ratio: from 1:3 to 3:1
  • Animation: none

And for videos:

  • Maximum number: 1
  • Minimum dimensions: 640 px × 640 px
  • Maximum dimensions: 4096 px × 2160 px
  • Minimum duration: 10 seconds
  • Maximum duration: 30 seconds
  • Maximum file size: 50 MB
  • Aspect ratio: from 1:3 to 3:1


I think we need to take into account what restrictions Gnome Software has for screenshots @willcooke ?


Paging @robert.ancell, our GNOME Software guru.

Show screenshots on the web store?

GNOME Software has no limitation on the number of screenshots, though it doesn’t handle it particularly well (this is 100 screenshots):

It also doesn’t limit the screenshot sizes.

Appstream supports any number of screenshots in any size, though it doesn’t explicitly support videos. I’ve pinged the authors to see if it would need a new <video> tag or supplying a .avi (exactly what codecs are supported would need to be defined) for a screenshot would be sufficient here. Either way video support could be added to GNOME software but it doesn’t have it today.


I think the proposal on the screenshot image parameters makes sense, we can look at what’d be needed to implement this and come back with any needed changes to the idea.

Storing/handling videos is out of scope for the snap store. We can discuss adding external video URLs as snap metadata but should do so on a new thread.


Continuing the conversation here. Let me know your thoughts:


We will not host video media but will allow publishers to include links to media video from popular platforms in their snaps. Some platforms we discussed to introduce: (specifically for terminal-based snaps),, (already allowed in dashboard).


Right now we are only allowing users to upload image media related to Snaps but in the future, there will be public publisher pages which will allow users the ability to include their branding and perhaps some featured banner to be used in these pages.

There are 2 additional work streams that will help publishers to contribute with acceptable and great media types to the platform: be able to preview a Snap listing page and guidelines and rules for media types (i.e. safe zones for featured banners, guidance on what to showcase in screen shots, avoiding text as much as possible in screen shots…). These will be worked out once we have an agreed direction.

General details

  • Accepted media formats: PNG, Animated GIFs, JPG, JPEG
  • Maximum overall file size : 2 Mb

Media images related to Snaps

General Number Required Allowed aspect ratio Min size Max size Recommended size Max. file size
{snap-name}-icon 1 :heavy_check_mark: 1:1 40x40 512x512 256x256 256 kb
{snap-name}-featured 1 2:1 640x320 3840x1920 1920x960 2 Mb
{snap-name}-shot-# Up to 4 :heavy_check_mark: 1:1, 4:3, 16:9 480x480 3840x2160 1920x1080 2 Mb

Description of items from the table above:

  • Snap icon: This image will be shown in search results, store pages and its details page.
  • Snap featured: Storefronts might decide to promote a given snap and this media type will allow them to feature a Snap
  • Snap shots: Any image/s from a snap that will be displayed on the given public listing page

Media images related to Publishers

NOTE: We are not currently working on public publisher pages but it is something that will be worth considering in this thread.

General Number Required Allowed aspect ratio Min size Max size Recommended size Max. file size
{publisher-name}-icon 1 :heavy_check_mark: 1:1 40x40 400x400 256x256 256 Kb
{publisher-name}-banner 1 1:1 640x480 3840x2160 1920x1080 2 Mb

Description of items from the table above:

  • Publisher icon: Refers to a brand image to be displayed in Snap details pages and (future) public pages from publishers listing additional information

  • Publisher banner: To be used in (future) public publisher pages in case they will be featured somehow in any of the storefronts or used as a background image for their (future) public pages

Thoughts @cprov @evan @mpt ?


Regarding GNOME Software - we would implement this using a Web View for the videos. Based on previous discussions this is probably not going to be accepted upstream, so would have to be carried as a distro patch (and the videos wouldn’t show in other distros). The work is non-trivial but do-able.