---
title: "Homarr Icon Picker — Icon Sources & Custom Icons"
aliases: [homarr-icons, homarr-icon-sources]
tags: [homarr, homelab, dashboard, icons, self-hosted]
sources: [raw/Homarr documentation 15.md]
created: 2026-04-19
updated: 2026-04-19
---

## Overview

Homarr's icon picker aggregates icons from multiple upstream sources into a single searchable collection of **11,000+ icons**. Used when configuring apps, bookmarks, and widgets.

## Icon Sources

| Source | Notes |
|--------|-------|
| [Dashboard Icons](https://dashboardicons.com/) | Recommended — 1,888+ curated, dashboard-specific icons |
| [selfh.st icons](https://github.com/selfhst/icons) | Community-maintained homelab icons |
| [Simple Icons](https://github.com/simple-icons/simple-icons) | Brand/service icons |
| [Tabler Icons](https://tabler-icons.io/) | General UI icon set |
| [Papirus Icons](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme) | Linux desktop icon theme |
| [Homelab SVG Assets](https://github.com/loganmarchione/homelab-svg-assets) | Homelab-specific SVG icons |
| Local (Media library) | Any file uploaded via the [[wiki/homelab/homarr-apps\|Apps]] media feature |

## Using the Icon Picker

- Open via any item that has an icon field (app, bookmark, widget)
- Type a search term — results filter across all sources in real time
- Icons marked with a red **SVG** badge are vector-format (scalable, print-quality)

## Finding Missing Icons

1. Search [Dashboard Icons](https://dashboardicons.com/) directly — broader selection with a modern UI
2. If still not found, use an **external URL**: paste a direct link to the icon file
   - URL must point directly to the image file (no wrapper pages or ads)
   - Supports any publicly accessible image URL

## Local Icons

Upload custom icons via **Management → Media**, then they appear automatically in the picker under the "Local" source. Useful for internal apps or custom branding.

## Key Takeaways

- 11,000+ icons across 6 upstream sources + local media uploads
- Dashboard Icons is the go-to fallback when built-in search fails
- SVG badge = vector format (preferred for sharp rendering at any size)
- External URL support covers any icon not in the bundled sources
- Local icons flow through the [[wiki/homelab/homarr-apps\|Apps media feature]] — no manual path config needed

## Related

- [[wiki/homelab/homarr-apps|Homarr Apps — Managing Dashboard Links & Status Checks]]
- [[wiki/homelab/homarr-bookmarks-widget|Homarr Bookmarks Widget — App Link Collection]]
- [[wiki/homelab/homarr-boards|Homarr Boards — Dashboard Management]]

## Sources

- `raw/Homarr documentation 15.md` — Homarr v1.59.2 official docs, Icon Picker section
