Meridianby Commenda
Components

Tag

A value someone chose or applied.

A value chip: something chosen or applied, like a country in a Multi-select or a filter on the guides library. Two sizes, sm 20 and md 24, with radius 4. Tags are values, not statuses (Badge) and not filters you open (Pill).

United Statessm · 20
United Statesmd · 24

Usage

Example.tsx
import { Tag } from "@commenda/meridian/ui/tag";
import { USFlag } from "@commenda/pathfinder/flags";

<Tag label="United States" leadingIcon={<USFlag size={12} />} removeConfig={{ onRemove }} />;

Sizes

sm 20 sits inside a 40 field and in dense lists. md 24 stands on its own, like filter chips above a list of guides.

United Statessm · 20
United Statesmd · 24

Removable or fixed

x removes the value. Turn it off where the value cannot be removed here, and for the +N count.

United StatesGermanySales tax+3

Leading flag or icon

Countries and jurisdictions always lead with their 12 flag. A 12 icon is for other kinds of things, like a product or a topic.

United KingdomIndiaSingaporeTransfer pricing

Tones and states

Neutral for values people chose. Blue marks an applied filter, so people can see what is narrowing the list. Hover darkens one step. Disabled follows the field it sits in.

Sales taxneutral
Sales taxblue
Canadadisabled

Anatomy

Soft Pearl 200 fill with a 0.5 hairline, radius 4, 6 on the left and 4 on the right, 4 between parts. sm: 20 high, Label/12 in Soft Pearl 1000, x 12 in Soft Pearl 800. md: 24 high, Label/13.

API reference

PropTypeDescription
labelRequiredstringFrom Pathfinder.
size"md" | "sm"Figma size: sm 20 inside fields and dense lists, md 24 standing on its own.
tone"neutral" | "blue"From Pathfinder.
leadingIconReactElement<unknown, string | JSXElementConstructor<any>>From Pathfinder.
removeConfigObjectView fieldsFrom Pathfinder.
classNamestringFrom Pathfinder.
idstringFrom Pathfinder.
removeConfigObject fields
FieldTypeDescription
onRemoveRequired() => void
labelstring
isDisabledboolean

Best practices

  • Use Tag for values someone chose or applied: countries in a Multi-select, filters on the guides library, topics on a post.
  • A status (Live, New, Coming soon) is a Badge, not a Tag. Badges are read-only, colored by meaning and never removable. A filter people open is a Pill.
  • Keep labels short. A Tag never wraps. Long names truncate with an ellipsis and show in full on hover.
  • x removes the value at once. On a filter row, offer Clear all at the end.
  • Countries always lead with their flag, and so do jurisdictions. Icons are for other kinds of things.
  • Source: Pathfinder Tag. Meridian adds size md 24 beside Pathfinder’s 20, now sm.

On this page