Icon

Icon renders Plugin Kit’s raw SVG set — no icon font. Size follows font-size; fill follows currentColor. Prefer the icon prop over name in Craft forms (namespaced name props get rewritten).

Register the icons you use

<Icon icon="…"> looks up glyphs by kebab-case name. The registry starts empty so production CP bundles only pay for icons you register. Import the element, then register named (camelCase) exports — keys normalize to kebab automatically:

import '@verbb/plugin-kit-web/components/icon.js';
import { registerIcons, plus, gear, ellipsis, arrowsRotate } from '@verbb/plugin-kit-icons';

registerIcons({ plus, gear, ellipsis, arrowsRotate });
// → <Icon icon="plus"> / icon="gear" / icon="ellipsis" / icon="arrows-rotate"

Need every curated glyph (docs, workshops, prototypes)?

import '@verbb/plugin-kit-icons/all.js';

The no-build loader and registerAll() already load the full set.

Gallery

Every built-in icon from @verbb/plugin-kit-icons — the canonical name list. Click a tile to copy its <Icon> tag. Generated from the package, so new glyphs appear here automatically. Prefer arrows-rotate for reload controls over arrow-rotate-left / arrow-rotate-right.

Paths are stored edge-cropped; at render time the viewBox expands to a centered square so every glyph fills the 1em host evenly.

Common Icons

A handful of icons most plugins reach for — including arrows-rotate.

Sizing

Scale icons with font-size on the host (defaults to 1em).

Alignment

<Icon> is a square 1em host with vertical-align: -0.125em so inline icons sit with surrounding text. Scale with font-size; no extra sizing CSS is required.

Narrow glyphs (for example ellipsis-vertical) keep even side padding inside that square — intentional, so every icon shares the same box. Button start/end slots center icons in flex and turn off the baseline nudge.

Color

Tint via CSS color — icons use currentColor.

Accessibility

Icons are decorative by default (hidden from assistive technology). Set label when the icon alone conveys meaning.

In Context

Slot into other components — buttons stay icon-agnostic via slot="start" / slot="end".

API

Props

Name	Description
icon	Icon name (kebab-case), e.g. chevron-down, gear, xmark. Namespacing-safe alternative to name — use this inside CMS form markup. Type string
label	Accessible label. When set the icon is exposed as an image with aria-label; otherwise it is hidden from assistive technology. Does not use HTML/SVG title (no native hover tooltip). Type string | undefined
name	Icon name (kebab-case). Back-compat / non-form alias for icon. Avoid in server-namespaced forms, where name attributes get rewritten. Type string