diff --git a/docs/database/overview.md b/docs/database/overview.md
index 70c0d6f70..23a266373 100644
--- a/docs/database/overview.md
+++ b/docs/database/overview.md
@@ -330,6 +330,8 @@ Previous versions used `useKV` hooks directly. The new Database layer provides:
 5. **Easier Testing**: Mockable database layer
 6. **Data Portability**: Export/import functionality
 
+Note: `useKV` now persists to `localStorage` in the browser and syncs updates across tabs when available, but it remains client-only. Use the Database layer for server-side, multi-tenant, or durable data.
+
 ### Migration Example
 
 **Before:**