diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
index 253d3e46aec8b36acf055a567f1fc125377fb03d..2c5f1fc65fc9284ab32d51e051a72413475ff3b3 100644
--- a/docs/src/SUMMARY.md
+++ b/docs/src/SUMMARY.md
@@ -7,6 +7,7 @@
 - [Linux](./linux.md)
 - [Windows](./windows.md)
 - [Telemetry](./telemetry.md)
+- [Workspace Persistence](./workspace-persistence.md)
 - [Additional Learning Materials](./additional-learning-materials.md)
 
 # Configuration
diff --git a/docs/src/workspace-persistence.md b/docs/src/workspace-persistence.md
new file mode 100644
index 0000000000000000000000000000000000000000..188b51461640ec41e322dbaa0d8a9c9fe9f1f1b3
--- /dev/null
+++ b/docs/src/workspace-persistence.md
@@ -0,0 +1,14 @@
+# Workspace Persistence
+
+Zed creates local SQLite databases to persist data relating to its workspace and your projects. These databases store, for instance, the tabs and panes you have open in a project, the scroll position of each open file, the list of all projects you've opened (for the recent projects modal picker), etc. You can find and explore these databases in the following locations:
+
+- macOS: `~/Library/Application Support/Zed/`
+- Linux: `~/.local/share/Zed`
+- Windows: `%LOCALAPPDATA%\Zed`
+
+The naming convention of these databases takes on the form of `0-<zed_channel>`:
+
+- Stable: `0-stable`
+- Preview: `0-preview`
+
+**If you encounter workspace persistence issues in Zed, deleting the database and restarting Zed often resolves the problem, as the database may have been corrupted at some point.**