diff --git a/docs/app_settings_reference.md b/docs/app_settings_reference.md
index 4045d20..dd44697 100644
--- a/docs/app_settings_reference.md
+++ b/docs/app_settings_reference.md
@@ -51,6 +51,7 @@ Complete reference for every setting in MeshMapper. The Settings tab is a list o
 
 - Chooses how the Top Heard list is drawn on the Live Activity (Lock Screen and Dynamic Island), CarPlay and Apple Watch
 - **On** (default): named rows, one repeater per line
+- Named rows show your own nickname for a repeater when you have set one (see [Repeater Nicknames](#repeater-nicknames))
 - **Off**: a compact grid that fits more repeaters
 
 ### Exit (Android only)
@@ -124,6 +125,14 @@ Download map areas to your device for wardriving without a data connection. Open
 - Makes the Top Heard overlay bigger for easier reading
 - Shown only while **Top Repeaters on Map** is on. Disabled by default.
 
+#### Repeater Nicknames
+
+- Give repeaters your own short names, up to 8 characters, like **Mell** for `5007`
+- The nickname shows instead of the hex ID in the **Top Heard** overlay, and in place of the repeater's name on the Live Activity, CarPlay, Apple Watch and Siri
+- It shows only when the app can tell exactly which repeater was heard. If another repeater shares the same ID, the ID shows instead.
+- Add one here with **+**, or tap a repeater on the map, open its details and tap **Nickname** beside **Manage**. Tap a nickname in the list to change it, or the bin to remove it.
+- Nicknames are saved on your phone and stay set when you leave a region and come back. They are not shared or synced to your MeshMapper account.
+
 ---
 
 ## Wardriving
diff --git a/docs/app_tabs.md b/docs/app_tabs.md
index 984905d..0240a1e 100644
--- a/docs/app_tabs.md
+++ b/docs/app_tabs.md
@@ -113,7 +113,7 @@ The overlay renders from the same vector coverage tiles as the web map, using yo
 **Tap to inspect:**
 
 - **Tap a coverage cell** to open a summary of its pings, with dashed connection lines fanning out to every repeater that heard that spot (each line labelled with distance).
-- **Tap a repeater** to see its details plus all the coverage cells it has been heard from, colour-coded by status, while the rest of the map dims so its footprint stands out. The repeater sheet also has a **Manage** button for logging in to a repeater you administer (it needs the repeater's full key and admin password).
+- **Tap a repeater** to see its details plus all the coverage cells it has been heard from, colour-coded by status, while the rest of the map dims so its footprint stands out. The repeater sheet also has a **Manage** button for logging in to a repeater you administer (it needs the repeater's full key and admin password). Beside it, a **Nickname** button gives the repeater your own short name, and shows that name once it is set.
 
 If **Top Repeaters on Map** is enabled in Settings > Map, a **Top Heard** overlay appears on the map. **Larger Top 3 Overlay** makes it bigger.
 
@@ -127,6 +127,8 @@ If **Top Repeaters on Map** is enabled in Settings > Map, a **Top Heard** overla
 
 Each row also shows the repeater's hex ID and SNR value, colour-coded: green (good, above 5), orange (okay, above -1 up to 5), red (poor, -1 or below).
 
+If you have given a repeater a nickname (Settings > Map > Repeater Nicknames), its row shows the nickname instead of the hex ID, as long as no other repeater shares that ID.
+
 The overlay clears when you stop auto-ping, switch modes, disconnect, or clear pings/logs.
 
 Example: