## `label`

### Signature

```solidity
function label(address addr, string calldata label) external;
```

### Description

Sets a label for an address in test traces. If an address is labelled, the label will show up in test traces instead of the address.

### Parameters

| Parameter | Type      | Description                      |
|-----------|-----------|----------------------------------|
| `addr`    | `address` | The address to label             |
| `label`   | `string`  | The label to assign              |

### Examples

```solidity [test/Label.t.sol]
address alice = makeAddr("alice");
vm.label(alice, "Alice's Address");
// In traces, alice's address will now show as "Alice's Address"
```

### Related Cheatcodes

* [`getLabel`](/reference/cheatcodes/get-label) - Retrieves the label for an address