build69
build69  /  Components  /  Data Display  /  TagCloud

TagCloud

v1.0.4Updated 27 Aug 2026

Visible cluster of selectable tag chips (filter rail, blog cloud, category picker). Three selection modes (none / single / multi), three layouts (wrap / horizontal-scroll / grid), six variants (default / outline / subtle

Preview

Live · 15 stories
DefaultOpen ↗
Why this is recommendedformtagschipsfilter+4

The default, out-of-the-box TagCloud.

Recommended for+14
  • Filter rails
  • Blog tag clouds
  • Category pickers
  • Faceted search summary
Tags+6
formtagschipsfiltercloudfacetscategory-pickerdefault
Features+4
  • Selection modes: none (display) / single / multi
  • Layouts: wrap / horizontal-scroll / grid
  • Variants: default / outline / subtle / pill / ghost / soft (vivid border + tinted bg in the same tone)
  • Sizes: sm / default / lg
  • weightByCount blog-cloud sizing
  • Per-tag count badge
  • Searchable filter input
  • Clear-all when something selected
  • Sort: label / count asc + desc
  • Per-tag tone / icon / disabled
  • i18n: labels prop overrides every built-in string (search, clear controls, empty states)
Not recommended for−2
  • Chip-style multi-input (use TagInput)
  • Single dropdown (use Combobox)

Install

Ask your agent, or call the MCP tool directly. The resolved bundle is written into your project.

get_registry_item({ name: "TagCloud" })

Usage

import { TagCloud } from '@/components/data-display/tag-cloud';

<TagCloud
  tags={topics}
  selectedIds={picked}
  onSelectionChange={setPicked}
  selectionMode="multi"
  weightByCount
  searchable
/>

Tick variants in the left menu — each adds a tab with that variant’s real story source, the same code the preview above renders.

Props

PropTypeRequired
tags

Tag list with optional count

TagCloudTag[]yes
selectionMode

Selection mode (default multi)

'none' | 'single' | 'multi'
selectedIds

Selected ids

string[]
onSelectionChange

Selection callback

function
weightByCount

Blog-cloud sizing by count

boolean
layout

Layout mode

'wrap' | 'horizontal-scroll' | 'grid'
gridCols

Grid column count

number
showCount

Show count next to label

boolean
sort

Sort mode

'label-asc' | 'label-desc' | 'count-desc' | 'count-asc' | 'none'
searchable

Show filter input above

boolean
variant

Visual variant. 'soft' pairs a soft tinted background with a vivid (solid) border in the same tone.

'default' | 'outline' | 'subtle' | 'pill' | 'ghost' | 'soft'
size

Size scale

'sm' | 'default' | 'lg'
showClear

Show clear-all when selected

boolean
labels

Override any built-in UI string — search placeholder/aria, clear controls, group aria-label, empty states (i18n). Merged over DEFAULT_TAG_CLOUD_LABELS; {token} templates

Partial<TagCloudLabels>

Related