diff --git a/assets/settings/default.json b/assets/settings/default.json
index 72262196dcf0495e913af1fba6635582bf3baf45..cd2bb248582c555df2473fc036ed7a3fb4a7e04c 100644
--- a/assets/settings/default.json
+++ b/assets/settings/default.json
@@ -379,6 +379,9 @@
   // 3. Never populate the search query
   //    "never"
   "seed_search_query_from_cursor": "always",
+  // When enabled, automatically adjusts search case sensitivity based on your query.
+  // If your search query contains any uppercase letters, the search becomes case-sensitive;
+  // if it contains only lowercase letters, the search becomes case-insensitive.
   "use_smartcase_search": false,
   // Inlay hint related settings
   "inlay_hints": {
diff --git a/docs/src/configuring-zed.md b/docs/src/configuring-zed.md
index 74ec806d6996bab4aff830f635b7aaa95d8fd9ce..7284fe5d520842155c78726a9038114f6a3f365b 100644
--- a/docs/src/configuring-zed.md
+++ b/docs/src/configuring-zed.md
@@ -1762,6 +1762,23 @@ Or to set a `socks5` proxy:
 },
 ```
 
+## Use Smartcase Search
+
+- Description: When enabled, automatically adjusts search case sensitivity based on your query. If your search query contains any uppercase letters, the search becomes case-sensitive; if it contains only lowercase letters, the search becomes case-insensitive. \
+  This applies to both in-file searches and project-wide searches.
+
+  Examples:
+
+  - Searching for "function" would match "function", "Function", "FUNCTION", etc.
+  - Searching for "Function" would only match "Function", not "function" or "FUNCTION"
+
+- Setting: `use_smartcase_search`
+- Default: `false`
+
+**Options**
+
+`boolean` values
+
 ## Show Call Status Icon
 
 - Description: Whether or not to show the call status icon in the status bar.