Skip to main content

Guidelines for Adding Icons to your Marketplace Add-On

Updated on
Aug 7, 2024

2 min read

Overview

When creating a Marketplace add-on, you can add an icon to serve as a visual identifier for your users. The icon appears in many places (e.g., the Marketplace website and users' dashboards), so it is important that your icon is easy to view in any size and follows certain rules. In this guide, we will walk through guidelines and best practices for uploading a great add-on icon.

Here is an example of an icon in context:

File Specifications

SpecDetail
File type.png
BackgroundTransparent
Size24x24px
Avoid going too much higher than 24x24px.
In some cases the icon will be resized down to 16x16px which will make the icon unrecognizable if it's too large
Aspect ratio1:1 (square)
Resolution72 dpi
CornersNo round corners

Colors

Foreground

We prefer dark colors with good contrast to be seen against a light background.

Background

A transparent background is the only accepted background.

Grid

Your icon should be designed to fill 10/12ths (20px for a 24px icon) of a vertical or horizontal space. Make sure to leave a margin of at least 1/12th (2px for a 24px icon) margin around your icon that is free of any visual elements.

'Add-on Icon Grid'

Example

An example of an icon with a proper marginGrid properly applied to the icon design
'An example of an icon with a proper margin''Grid properly applied to the icon design'

DOs & DON'Ts

Contrast

DON'T use low contrast foreground colorsDO use nice contrast colors. Transparent background is a plus!
'DO NOT use low contrast foreground colors''DO use nice contrast colors'

Margins

DON'T export the icon without any marginsDO give your icon some room to breath
'DO NOT export the icon without any margins''DO give your icon some room to breath'

Visual effects

DON'T use drop shadows, bevel, emboss, or
any other similar visual effects because those don't downscale well
DO use outline icons with proper line width. They look sharper while downscaling
'DO NOT use drop shadows, bevel, emboss, or any other similar visual effects because those don't downscale well''DO use outline icons with proper line width. They look sharper while downscaling'

Copy

DON'T use excessive amounts of text in your icon.
This makes it hard to identify and read at smaller sizes
DO use a mark that will visually represent your add-on
'DO NOT use excessive amounts of text in your icon''DO use a mark that will visually represent your add-on'

Ownership

DON'T use a logo and a name you don't ownDO use a original mark and name
'DO NOT use a logo and a name you don't own''DO use a original mark and name'

Example of a Proper Icon

In the top left corner of the add-on below, you will see an example of a proper icon that adheres to all of the guidelines.

'Sample Add-on Icon'

Wrap Up

For more information about Marketplace, check out QuickNode Marketplace or more Marketplace Guides.

We <3 Feedback

If you have any feedback or questions on this guide, let us know. We'd love to hear from you!

Share this guide