Latest Content

How to Add a Gallery Image

Updated on 05 August, 2026

Add a gallery image to a Vultr Marketplace app using the Vultr Console or Vultr API to showcase app screenshots on the application's public landing page.

Gallery images appear as screenshots and featured images on the application's public landing page.

This guide explains how to add a gallery image using the Vultr Console or the Vultr API.

Gallery images must meet the following requirements:

  • The aspect ratio must be 8:5. The API enforces a minimum width of 133% of the height and returns a 422 error ("Not wide enough...") for narrower images.
  • The recommended size is 800x500 pixels.
  • The file format must be JPG, GIF, or PNG.
  • Vultr Console
  • Vultr API

  1. Click Marketplace in the Vultr Console's left-hand menu.

  2. Click the application name to open the Edit App screen.

  3. Click the Gallery tab.

  4. Click the Upload Graphic button and choose an image to upload. Verify that a thumbnail appears in the Gallery tab after the upload completes.

Send a POST request to the Add Image to Marketplace App endpoint. Replace {app-id} with the app's ID and BASE64-IMAGE with a base64-encoded image.

console 
$ curl "https://api.vultr.com/v2/marketplace/apps/{app-id}/images" \
    -X POST \
    -H "Authorization: Bearer ${VULTR_API_KEY}" \
    -H "Content-Type: application/json" \
    -d '{
        "b64_image": "BASE64-IMAGE"
    }'

A successful request returns an HTTP 201 Created response with the image's id, filename, and url.

Comments