# Table.rename
URL: https://lsd.tools/docs/api-table-rename
Updated: 2026-07-17

## Parameters

| name | type | default | description |
|---|---|---|---|
| `mapping` | `Mapping[str, str]` | — | an `{old: new}` dict; columns not listed are left unchanged |

## Example

```python
t.rename({"au_ppm": "gold", "cu_pct": "copper"})
```

## Notes

Only the columns you list are renamed; every other column keeps its name and the overall
order is preserved. Every call returns a **new** `Table`.

## See also

**API:** [select](/docs/api-table-select) · [drop](/docs/api-table-drop) · [with_column](/docs/api-table-with-column)

**Guides:** [Tables & data flow](/docs/tools-tables)