Features

Custom icons

Add your own icons to the icon picker

Admins can add their own icons by mounting a folder into the container (see the commented volumes example in the docker-compose*.yml files):

volumes:
  - /<your_path>/firefly-pico-icons:/var/www/html/storage/app/custom-icons:ro
  • Supported formats: .svg, .png, .webp, .jpg/.jpeg. Only files directly in the folder are used (no subfolders).
  • The icons appear in a Custom tab of the icon picker. New files are picked up when the picker is opened or on the next sync.
  • The file name (without extension) is the name used for search, so name files descriptively (e.g. coffee.svg).
  • In dark mode custom icons are inverted (like the built-in ones), so dark line icons (e.g. from svgrepo.com) work best.
Outside Docker, the folder can be changed with the CUSTOM_ICONS_PATH env variable.
Copyright © 2026