Guidelines for creating a GitHub Marketplace listing

When creating a GitHub Marketplace listing, you're required to provide images such as logos and screenshots. These guidelines will help you create those images.

Pricing and plans

Your GitHub Marketplace listing must have at least one paid plan. Additional free plans are optional but encouraged. Users will pay for your app using their own specified GitHub payment method. For more information, see "About GitHub Marketplace pricing plans."

Logo and badge images

GitHub Marketplace displays all listings with a square integration logo image inside of a circular badge. You can choose a background color for this badge, which can be used to visually distinguish your app in the GitHub Marketplace.

Tips for logo and badge images

Upload an image that is at least 200px x 200px to avoid upscaling images on GitHub Marketplace listings.

If possible, upload a square logo with your logo in the center, as logos will be cropped to a square.

You can use transparent PNGs if you'd like to lay your logo on top of a badge's background color.

You can assign a badge color to match the background color (or transparency) of a logo image to give the appearance of a seamless badge.

You should avoid using logos with words or text in them as they do not scale well to small sizes.

Screenshot images

When browsing GitHub Marketplace, people can see up to five screenshot images for an app. These images are displayed within a carousel. Thumbnail navigations are provided to switch from one image to the next. Each screenshot may have an optional caption to help add context.

Tips for screenshots

Images should be of high resolution (at least 1200px wide).

Images should all be the same height and width (aspect ratio) to avoid page jumps when users navigate from one image to the next.

Try to show as much of the user interface as possible to help visually explain what your app does.

Avoid showing your app in Chrome, as this does not scale well to smaller screen sizes.

Images are shown within a box, so you don't need to include another box around your screenshot.

Captions are most effective when they are short and snappy.

Feature cards

A feature card is a rectangular background image that contains the GitHub Marketplace listing's badge and name. A short description of the listing is displayed underneath the feature card. The background image should have some texture to give your feature card a sense of identity and allow it to stand out against the background color on the GitHub Marketplace homepage.