# wallet-cli rename

Rename an account label.

## Synopsis

```
wallet-cli rename <account> --label <new> [options]
```

## Arguments

- `account` — accountId, current label, or address to rename

## Options

| Option | Description |
|---|---|
| `--label <string>` | new unique label, 1-64 chars  [required] |

Plus [global options](index.md).

## Notes

The stable handle is always the `accountId`; only the label changes. Metadata-only — no master password needed.

## Examples

```bash
wallet-cli rename main-1 --label hot-hd
```

```console
✅ Renamed account
  Old label  main-1
  New label  hot-hd
```

```bash
wallet-cli rename main-1 --label hot-hd -o json
```

```json
{"schema":"wallet-cli.result.v1","success":true,"command":"rename","data":{"previousLabel":"main-1","accountId":"wlt_kwyjcwdh.1","label":"hot-hd","type":"seed","index":1,"active":true,"addresses":{"tron":"TVz38F2QmQf53g7QVATBbsZ6JkHKccJFAQ","evm":"0xEA4A61822322c695F5A9eB7920b843054CbDaA83"},"seedId":"wlt_kwyjcwdh","derivationPath":null},"meta":{"durationMs":26,"warnings":[]}}
```

## Output

`data` is the renamed account, plus `previousLabel`. Local command — no `chain` block.

| Field | Type | Meaning |
|---|---|---|
| `previousLabel` | string | The old label before renaming |
| `accountId` | string | Stable account id (unchanged by rename) |
| `label` | string | The new label |
| `type` | string | `seed` / `privateKey` / `watch` / `ledger` |
| `index` | number \| null | HD derivation index; `null` for non-HD accounts |
| `active` | boolean | Whether it is the active account |
| `addresses` | object | One entry per family the account can produce: `tron` (base58) and/or `evm` (`0x`, EIP-55 checksummed) |
| `seedId` | string | Owning seed wallet id (`seed` accounts only) |
| `derivationPath` | null | Always `null`, deliberately — `rename` takes no master password, so it cannot tell an old TRON path from a current one without opening the seed; `derive` and `backup` report verified paths |
| `family` | string | Chain family this account is bound to — single-family accounts (`watch`, `ledger`) only |
| `path` | string | The account's derivation path on the device (`ledger` accounts only) |

## Exit status

`0` success · `1` execution failure · `2` usage error. See [machine-interface](../machine-interface.md).

## See also

[`list`](list.md) · [`use`](use.md)