Icons

The Icons screen lists every glyph the keyboard draws, grouped by where it appears, with the active pack’s controls above the list. This page walks the screen top to bottom; for why you’d swap icons and how to build a pack of your own, see Icon packs instead.

Screenshot pending

The Icons screen: the active pack (with export and delete on each installed row), then the slot list.

Options

WM Keyboard›Appearance›Icons

Reach it from Appearance → Style → Icons, or by searching “Icons” in settings search.

Icon pack

The first group lists Built-in icons (always the top row, selected whenever no pack is active), followed by one row per pack you’ve installed. Each installed row shows the pack’s name, its icon count, and its author and version when the pack’s manifest set them (for example “42 icon(s) · Jamie · v1.2”). Tapping any row switches to it immediately.

Every installed row also carries two trailing buttons the built-in row doesn’t have:

• Export opens a save dialog and writes that pack out as a .wmicons file, named after the pack. You’ll see “Saved <pack name>.” on success, or “Could not write that file.” if the write fails.
• Delete asks for confirmation first (“Delete <pack name>? Its <N> icon(s) are removed from this device.”) before removing the pack’s files and any per-slot override pinned to it.

Screenshot pending

Confirming deletion of an installed icon pack.

Download, import and reset

Three rows sit below the pack list, in their own untitled group:

Row	What it does
Download more	Opens the addon catalogue, already filtered to icon packs
Import an icon pack	Opens a file picker for a .wmicons file and installs it, switching to it right away
Reset all icons	Turns off the active pack and clears every per-slot override in one step. Installed packs are kept: subtitle reads “This turns the pack off and deletes every single-icon change. The app keeps the installed packs.”

Download more sits first, next to the file importer, because the two answer the same question from opposite ends: one takes a .wmicons file you already have, the other goes looking for packs in whichever repositories you’ve added. See Installing addons.

Reset all icons runs immediately with no confirmation dialog, unlike deleting a pack; afterward you see “Every icon is back to the built-in one.”

The slot list

Below that, the rest of the screen is the 93 replaceable slots, in four groups, each its own section:

Section	Covers	Slots
Tools	Every toolbar tool’s own icon	60
Keys	Shift (off/on/locked), backspace, forward delete, switch language, emoji key, and Enter in each of its six wordings (search, send, go, next, previous, done)	14
Toolbar	Toolbox, back-to-keys, show-tools, emoji shortcut, close search, incognito badge	6
Emoji tabs	Search, recent, most used, and one per emoji category	13

Each row’s subtitle names where that icon currently comes from: the label of a built-in icon you picked by hand, “From <pack name>” if it’s pulling from a pack (per-slot override or the active pack), or “Default” once nothing overrides it. The Tools rows use each tool’s own settings-screen name, so a row here and that tool’s own icon setting always agree on what it’s called.

Replacing one icon

Tapping any slot row opens its picker: a search field (placeholder “Search Material Symbols”) over a grid of the 181 built-in icons, filtered live as you type. Tapping one sets that slot immediately and closes the dialog.

Screenshot pending

The per-slot picker: search, the built-in grid, and Use my own SVG…

Below the grid, Use my own SVG… opens a file picker restricted to SVG-ish MIME types. A file that parses and fits under 256 KB is written into the reserved My icons pack and the slot is pinned to it, with “Set a custom icon for <slot>.”; one that doesn’t gets “That file could not be used as an icon. It has to be an SVG under 256 KB.”

The dialog’s confirm button reads Use default, not “OK”. It resets only the slot you’re looking at, not the whole screen. If that slot had been pinned to an SVG you imported into “My icons,” resetting it also deletes that file from the pack, so it doesn’t linger in a later export of “My icons.” Cancel closes the dialog without changing anything.

Details & edge cases

• Import limits. The device holds at most 20 icon packs at once (the reserved “My icons” pack counts toward that total), each SVG inside a pack is capped at 256 KB, and a .wmicons archive itself is capped at 8 MB. Importing past the pack limit reports “You already have 20 icon packs. Delete one first.”; a file that isn’t a recognizable icon pack reports “That file is not a WM Keyboard icon pack.”; one that can’t be read reports “That file could not be read.”
• Resolution order for any slot is: a per-slot override you picked by hand, then the active pack (if it covers that slot), then the app’s built-in default. Setting one icon from the picker always wins over an installed pack, even after that pack is later updated or swapped for another.
• Deleting the active pack turns off “active pack” entirely, not just removing that row, so any slot that was relying on it (and wasn’t separately overridden) falls back to the built-in icon.
• Layout key glyphs aren’t here. The per-key symbols a language layout draws into its own keys (as opposed to the app’s chrome) are never part of this list; an icon pack can’t touch them. See Icon packs for why.
• Colour follows the theme by default. A row’s icon that sets no colour of its own picks up the current theme’s colour, plus that tool’s own accent colour when Colorful tool icons is on. See WM Keyboard›Tools.
• No edition restriction. Everything on this screen behaves the same on both editions of the app.

Related pages

• Icon packs — the guide: why you’d swap icons, installing a pack from an addon repository, and building your own from scratch.
• Appearance — the Style group this screen is opened from, alongside Keyboard themes and Keyboard font.
• Tools — Colorful tool icons, the toggle that decides whether a monochrome tool icon picks up its own accent colour.
• Backup & restore — icon packs are an optional, off-by-default section in a full settings export.