Icons
Name the icon, never redraw it
The icon language uses Lucide with one weight on a 24 px grid and a 2 px stroke. The curated set currently contains 49 icons. Its source is icons/icons.json. The icon build creates a class for Track A and a typed name map for Track B.
Do not place raw <svg> in authored markup. Use two class names in Razor and static HTML, or <Icon name="…" /> in React. This keeps the drawing and its meaning consistent across every surface.
How to use an icon
An icon is a CSS mask coloured by currentColor. It is not an image or a drawing in markup. It inherits semantic text colour and works across colour modes in Razor, static HTML, React, and presentation layouts.
<!-- Track A: Razor, static HTML, Slidev -->
<span class="id-icon id-icon-truck"></span>
<!-- Icon-only button -->
<button type="submit">
<span class="id-icon id-icon-trash-2"></span>
<span class="sr-only">Remove PRO Wear T-shirt 0300</span>
</button>// Track B: React
import { Icon } from '@id-identity/ui/Icon';
<Icon name="truck" />
<button type="button">
<Icon name="trash-2" />
<span className="sr-only">Remove PRO Wear T-shirt 0300</span>
</button>size.icon.sm 16pxsize.icon.md 20px (standard)size.icon.lg 24px
Size and stroke
The default size is 20 px and needs no size class. Use 16 px inline with body copy, badges, and compact lists. Use 24 px for prominent actions and empty states. The 2 px stroke belongs to the 24 px source grid and scales with the icon.
Accessibility
Mask icons are decorative and are not announced. Most sit beside text that already names the action. An icon-only control needs a screen-reader label that names the object, such as 'Remove PRO Wear T-shirt 0300', not just 'Remove'. Never use an icon as the only carrier of status or meaning.
One set, one weight
Use one icon set and one weight. Do not mix filled and outlined variants. If a surface needs illustration, treat it as a separate visual language rather than adding another icon style.
The set is curated, not locked
The generated set above is the complete approved vocabulary. If a meaning is missing, add one icon to icons/icons.json with a clear use statement, then rebuild the generated outputs. Adding an icon is a system decision, not a copy from search results.
icons/icons.jsonpnpm iconscheck:brand raw-svg
Direction 13
Where an action leads and what it closes.
arrow-downDecrease in a metric.arrow-leftGo back one step. Never replaces the browser back button.arrow-rightContinue in the same direction: editorial link, next step, or view more.arrow-upIncrease in a metric. The direction reports data, not approval.arrow-up-downSorting. Use in the sort control, not in table headers that already use aria-sort.chevron-downExpand a details element, select, or accordion. Rotates 180 degrees when open.chevron-leftPrevious pagination page or previous gallery image.chevron-rightNext pagination page, next gallery image, or breadcrumb separator.chevron-upCollapse content only when chevron-down cannot rotate.external-linkA link leaves the site or opens a new window. Required when target is _blank.linkCopy a link or indicate a shareable address.menuOpen mobile navigation. Use only for this purpose.xClose a drawer or dialog, or remove an active filter.
Status 8
What the system knows about the current state.
checkSelected, completed, or copied. A check without a ring confirms an inline action.circle-alertAn error that stops progress, such as a declined payment or missing field.circle-checkPositive system status, such as an order received or payment approved.infoNeutral information in a callout. Never use as the only tooltip trigger.loader-circleThe system is working. Rotates evenly and respects prefers-reduced-motion.lockSecure payment or content restricted by login.shield-checkTested, certified, or approved. Use only beside a documented claim.triangle-alertA warning with a consequence, such as a confirmed delivery change.
Catalogue 4
Finding and navigating products.
layout-gridGrid view in the view switcher.listList view in the view switcher.list-filterOpen filters. Sorting uses arrow-up-down.searchSearch field and search button.
Commerce 16
Basket, delivery, orders, and documents.
bellRequest a notification when an item is back in stock.copyCopy to the clipboard. Changes to check for two seconds after activation.credit-cardPayment method at checkout.downloadDownload a file. State the file type and size in adjacent text.file-textInvoice, data sheet, or certificate document.minusRemove one in a quantity stepper.packageBackorder, shipment, or package contents.pencilEdit an address, line, or name.plusAdd one in a quantity stepper or add a line.printerPrint the page. Use on quotes and orders intended for print.receiptReceipt and order confirmation. This set uses text-line geometry because a dollar sign is inappropriate for the Danish market.refresh-cwReturn or exchange.repeatReorder a previous order.shopping-cartThe cart. Use only in top navigation and the empty-cart state.trash-2Remove a cart line. Always include a screen-reader label naming the item.truckDelivery and delivery time.
Account 8
People, organisations, and account access.
building-2Company, partner, or company store.globeCountry and language in the footer.log-outSign out of the account.mailEmail channel for newsletters, order confirmations, or contact.map-pinDelivery address or find a partner.phoneCustomer service phone number.userMy account or sign in.usersPeople on a partner account.