Skip to main content
Version: 6.1

Custom Icon Requirements

Icons in SVG and PNG formats are supported. Icons must meet the requirements below to render correctly. If an icon file does not meet these requirements or cannot be read, the alert icon, an exclamation mark inside a triangle, is displayed instead of the custom icon.

SVG Icon Requirements​

An SVG file and the icon it contains must meet the following requirements:

  • the file must contain valid SVG markup
  • the icon aspect ratio, calculated as height divided by width, must be between 1/3 and 3/1
Important

Potentially unsafe code is removed from the icon. For example, code enclosed in <script>...</script> tags is removed.

PNG Icon Requirements​

A PNG file and the icon it contains must meet the following requirements:

  • the file must be a valid PNG file and comply with the PNG specification
  • the file size must not exceed 512 KB
  • the maximum image compression level is 50
  • the icon width and height must each be between 1 and 512 pixels
  • the icon aspect ratio, calculated as height divided by width, must be between 1/3 and 3/1