diff --git a/docs/developer/ui-controls.md b/docs/developer/ui-controls.md
index 89643e53..ebe9c5e2 100644
--- a/docs/developer/ui-controls.md
+++ b/docs/developer/ui-controls.md
@@ -212,6 +212,12 @@ label: Scan Interval (seconds)
where: Settings page → Scanning section
does: Sets the seconds between automatic scans.
+label: Force Rescan All Libraries
+where: /admin dashboard → Quick Actions
+does: Force-rescans every library — re-reads each file, re-extracts metadata with original-scan semantics, and recomputes hash identifiers. Unlike the shallow per-library and per-folder scans, nothing unchanged is skipped; this is the admin's backfill tool.
+also: Scan All Libraries
+note: renamed 2026-11-02 — the old label under-promised a heavy operation
+
label: Resume rewind
where: audio player → player settings; profile settings
does: Rewinds playback a configured few seconds when you resume.
diff --git a/templates/admin.templ b/templates/admin.templ
index 7e97bb90..cbde43f4 100644
--- a/templates/admin.templ
+++ b/templates/admin.templ
@@ -77,9 +77,9 @@ templ Admin(user User, stats AdminStats) {
diff --git a/templates/admin_templ.go b/templates/admin_templ.go
index 67fc596f..f7527480 100644
--- a/templates/admin_templ.go
+++ b/templates/admin_templ.go
@@ -167,7 +167,7 @@ func Admin(user User, stats AdminStats) templ.Component {
if templ_7745c5c3_Err != nil {
return templ_7745c5c3_Err
}
- templ_7745c5c3_Err = templruntime.WriteString(templ_7745c5c3_Buffer, 15, "Scan All Libraries Re-scan existing files and detect new items ")
+ templ_7745c5c3_Err = templruntime.WriteString(templ_7745c5c3_Buffer, 15, "Force Rescan All Libraries Re-reads every file and re-extracts metadata and hashes — slow but thorough ")
if templ_7745c5c3_Err != nil {
return templ_7745c5c3_Err
}