# CopyButton

Clipboard action with temporary copied feedback.

Use CopyButton for clipboard actions that need short, local confirmation.

## API

The package declarations define these public members.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `copiedIcon` | `IconGlyph` | prop | No | `CheckIcon` | Glyph shown after a successful copy. |
| `copiedLabel` | `string` | prop | No | `'Copied'` | a11y label announced after a successful copy. English fallback for locale-agnostic use — consumers should pass a localized string. |
| `label` | `string` | prop | No | `'Copy'` | a11y label in the idle state. English fallback for locale-agnostic use — consumers should pass a localized string. |
| `size` | `ButtonSize` | prop | No | `'md'` | No additional description. |
| `tone` | `'neutral' \| 'success'` | prop | No | `'neutral'` | Tint the copied-state icon with `--bd-success` for a confirmation cue. |
| `value` | `string` | prop | Yes | - | No additional description. |
| `variant` | `ButtonVariant` | prop | No | `'ghost'` | No additional description. |

## Related

- [Button](/docs/components/button): Primary action control or link with variants and loading state.
- [Chip](/docs/components/chip): Bindable toggle pill for compact filters on the shared control ladder.
- [Toolbar](/docs/components/toolbar): Data-driven toolbar with roving focus, action presentations and tones, and toggle groups.