---
title: "Custom Device Icons"
description: "Pick a device icon from the TapHome catalog, set its appearance, accent color and background, and add an overlay. With interactive dialog previews."
url: "https://taphome.com/en/docs/configuration/custom-icons/"
language: en
lastmod: 2026-11-06
generator: hugo
ai:
  topics: ["device-icons","icon-appearance","overlay-icon","device-configuration"]
  questions: ["How do I change a device icon in TapHome?","How do I give a device icon its own color?","What is an overlay?","How do I change the position of an overlay?","Why did the overlay disappear after I changed the icon?","How do I create an icon with my own text or emoji?","How many characters can the icon text have, and does an emoji count as one?","Why are the Default and Accent color appearances missing for an emoji icon?","What is the difference between the Default, Black and white, Off and Accent color appearance?","Which devices have which icon, and what changes it?","Why did the icons I set change after I changed the device type?"]
---

# Custom Device Icons

How to pick a device icon, change its appearance, color and background, and add an overlay

Last updated: 2026-11-06

You set the icon of a device in its **Service settings**: pick an icon from the catalog, then change its appearance, accent color and background, or add an overlay, a second icon drawn over it. Some devices, such as a blind, a slide, a thermostat or an RGB light, draw their icon from their state and have none to pick. Choose the device type first, because it overwrites the icons you have already set. The result is an icon, optionally with your own text or emoji of up to 5 characters, that tells similar devices apart.

## Where to set the icon

Open the **Service settings** of the device.

- **Digital output** and **Reed contact** have two icons, **Icon for "On"** and **Icon for "Off"**.
- **Analog output** has one **Icon** row. The picker offers only icons that draw a level, and the icon shows the current value of the output.
- **Push button** and **Variable** have one **Icon** row, and the icon does not change.
- **Multi-Value Switch** and **Multi-State Sensor** have an icon for each value: tap the value in the **Values** section.
- **Blind** and **Awning** have no icon to set. Their icon shows the position, and for a blind also the slat angle. **Thermostat** and **RGB Light** have no icon to pick: the thermostat's icon shows the set temperature, the RGB light's icon its color and brightness. **Temperature sensor**, **Analog input** and **Electric meter** get their icon from the device type.

Choosing the **Device type** in the **Attributes** section sets the icons by type – for a multi-value switch the icons of all values – and **overwrites the icons you have already set**, so pick the type before the icons. It also overwrites other properties that the type determines, for example the names of states and values, the minimum and maximum of a dimmer and **Negate state** of a reed contact. For an awning, the type determines the icon the app draws, for example a curtain or a **Mix valve**.



## Icon dialog



### Appearance

**Default** has the theme color of the app, **Black and white** is black (white in dark mode) and **Accent color** has a palette color independent of the theme; the **Accent color** row with the palette is there only with this appearance. **Off** dims the icon, but some icons, such as a lock  or a door, have their own artwork for the off state .

Without a background, some icons do not offer the **Accent color** or **Off** appearance. With a background all four are available.

### Background

With a background, the **Off** appearance always uses the artwork of the on state, for example the lock .

## Picking an icon

Picking a different icon resets the appearance and background and **removes the overlay**, so pick the icon first.

## Text and emoji

Pick a preset from the **Text (editable)** section and change it in the **Text** row to your own text or emoji.



The text has at most 5 characters including spaces, and a multi-part emoji (a family, a flag) counts as one character. Without a background the app offers only **Black and white** and **Off** for a color emoji, so keep the circle background.

## Overlay

An overlay is a second icon drawn over the device icon, for example a number that tells two identical devices apart. It comes from the same catalog, text and emoji included, and an icon has at most one.



1. **Background** – in a corner without a background, the lines of the overlay overlap the icon underneath.
2. **Position** – in a corner the overlay is half the size, in the center full size.

The badges for an error, a warning or manual mode in the top right corner of a device tile are drawn by the app according to the device state and have nothing to do with the overlay.

**See also** — [Dashboards, Zones, and Categories](https://taphome.com/en/docs/configuration/dashboards-zones-categories/), [Schemas](https://taphome.com/en/docs/schemas/).
