diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
index 253d3e46ae..2c5f1fc65f 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 0000000000..188b514616
--- /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.**