# IconStyleMapping

Canonical page: https://www.adaptabletools.com/docs/reference/iconstylemapping

One mapping in an  — `Key` is matched against the
cell's raw value, `Icon` is what gets drawn when it matches.

```ts title="TypeScript"
export interface IconStyleMapping 
```

## Properties

| Property | Type | Description |
| --- | --- | --- |
| [Description](https://www.adaptabletools.com/docs/reference/iconstylemapping.md#description) | `string` | Optional human-readable description of this mapping (e.g. the full<br/>country name when `Key` is an ISO code). Surfaced in the tooltip and<br/>by the wizard&#39;s mappings list. |
| [Icon](https://www.adaptabletools.com/docs/reference/iconstylemapping.md#icon) | [`IconStyleSpec`](https://www.adaptabletools.com/docs/reference/iconstylespec.md) | Icon to render when `Key` matches the cell value.<br/><br/>See  — accepts an `AdaptableIcon` (system /<br/>URL / element) or a plain string for emoji. |
| [Key](https://www.adaptabletools.com/docs/reference/iconstylemapping.md#key) | `string \| number \| boolean` | Cell value that triggers this mapping. Compared using the parent<br/> (defaults to strict equality).<br/><br/>Booleans and numbers are accepted to support typed columns (e.g.<br/>`Key: true` for an `isLive` flag, `Key: 0` for a status code). |

## Property Details

### Description

Optional human-readable description of this mapping (e.g. the full
country name when `Key` is an ISO code). Surfaced in the tooltip and
by the wizard&#39;s mappings list.

```ts title="TypeScript"
Description?: string;
```

###### Property Value

`string`

### Icon

Icon to render when `Key` matches the cell value.

See  — accepts an `AdaptableIcon` (system /
URL / element) or a plain string for emoji.

```ts title="TypeScript"
Icon: IconStyleSpec;
```

###### Property Value

[`IconStyleSpec`](https://www.adaptabletools.com/docs/reference/iconstylespec.md)

### Key

Cell value that triggers this mapping. Compared using the parent
 (defaults to strict equality).

Booleans and numbers are accepted to support typed columns (e.g.
`Key: true` for an `isLive` flag, `Key: 0` for a status code).

```ts title="TypeScript"
Key: string | number | boolean;
```

###### Property Value

`string | number | boolean`