---
url: "https://vueda.dev/v3/reference/api/vue/ScopeChip.md"
title: "ScopeChip"
---

# ScopeChip

## Overview

Renders one list scope as a read-only pill. A scope is a list constraint
supplied by a link or by application code that has no editable input, so the
label segment only describes it; when the scope is clearable, a trailing
segment asks to clear it.

Theme entry: [ScopeChip](/v3/reference/theming/keys/ScopeChip.md)

## Props

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| <span id="prop-iconOverride">iconOverride</span> | `Object` |  | `null` | A partial icon registry (`{ [componentName]: { [iconName]: { component, props } } }`) merged with inherited and default icon entries; scopes icon overrides to this component and its descendants. |
| <span id="prop-themeOverride">themeOverride</span> | `Object` |  | `null` | A partial ThemeObject keyed by component name, merged over this component's theme and provided to descendants. |
| <span id="prop-label">label</span> | `string` | yes |  | Readable description of the scope, such as "2 selected records" or a batch name. |
| <span id="prop-clearable">clearable</span> | `boolean` |  | `true` | When true, the chip shows a clear control. |

## Slots

| Name | Scoped | Description |
| --- | --- | --- |
| `default` |  | Replaces the label text. |

[Full slot reference](/v3/reference/api/vue/ScopeChip/slots.md)

## Events

| Name | Description |
| --- | --- |
| `clear` | Emitted when the reader activates the clear control. |

[Full event reference](/v3/reference/api/vue/ScopeChip/events.md)

## Source

`client/lib/display/scope/ScopeChip.vue`