diff --git a/crates/migrator/src/migrations/m_2025_10_21/settings.rs b/crates/migrator/src/migrations/m_2025_10_21/settings.rs
index 6fe8814fb43e6423bcc6d4ae04c3a1f7a4e975a3..1f78f9332741a50f851006c525863e51abc94784 100644
--- a/crates/migrator/src/migrations/m_2025_10_21/settings.rs
+++ b/crates/migrator/src/migrations/m_2025_10_21/settings.rs
@@ -9,6 +9,7 @@ pub fn make_relative_line_numbers_an_enum(value: &mut Value) -> Result<()> {
     *relative_line_numbers = match relative_line_numbers {
         Value::Bool(true) => Value::String("enabled".to_string()),
         Value::Bool(false) => Value::String("disabled".to_string()),
+        Value::String(s) if s == "enabled" || s == "disabled" || s == "wrapped" => return Ok(()),
         _ => anyhow::bail!("Expected relative_line_numbers to be a boolean"),
     };
     Ok(())
diff --git a/docs/src/configuring-zed.md b/docs/src/configuring-zed.md
index 218b25f569d2530cf47faa1b393a64080412d734..3aabc05b7adb1b2a938f9538c8c87dee727a76ec 100644
--- a/docs/src/configuring-zed.md
+++ b/docs/src/configuring-zed.md
@@ -2996,11 +2996,33 @@ List of `string` glob patterns
 
 - Description: Whether to show relative line numbers in the gutter
 - Setting: `relative_line_numbers`
-- Default: `false`
+- Default: `"disabled"`
 
 **Options**
 
-`boolean` values
+1. Show relative line numbers in the gutter whilst counting wrapped lines as one line:
+
+```json [settings]
+{
+  "relative_line_numbers": "enabled"
+}
+```
+
+2. Show relative line numbers in the gutter, including wrapped lines in the counting:
+
+```json [settings]
+{
+  "relative_line_numbers": "wrapped"
+}
+```
+
+2. Do not use relative line numbers:
+
+```json [settings]
+{
+  "relative_line_numbers": "disabled"
+}
+```
 
 ## Remove Trailing Whitespace On Save