How to Upload App Icons

Updated on 05 August, 2026

Upload icons for a Vultr Marketplace app using the Vultr Console or Vultr API to display your brand across the Marketplace listing and deployment pages.


An app needs two icons: a light-mode icon and a dark-mode icon. Vultr displays whichever matches the customer's Console theme.

This guide explains how to upload app icons using the Vultr Console or the Vultr API.

  • 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. Expand the Icons section.

  4. Click Upload under Light Mode and select a square image at least 100 by 100 pixels.

  5. Click Upload under Dark Mode and select a square image at least 100 by 100 pixels.

    Verify that both icons display in the Icons section.

Send a PUT request to the Create Marketplace App Icon endpoint for each icon. Replace {app-id} with the app's ID and BASE64-IMAGE with a base64-encoded image of 6 MB or less. Set theme to light_mode or dark_mode.

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

The response contains the uploaded icon's image_url. Repeat the request with theme set to dark_mode to upload the second icon.

Comments