diff --git a/README.md b/README.md
index 9c0d50f7..6c13ee2c 100644
--- a/README.md
+++ b/README.md
@@ -377,10 +377,38 @@ It also includes a built-in scheduled import feature with `archivebox schedule`
-## Output formats
+### Archive Layout
All of ArchiveBox's state (including the index, snapshot data, and config file) is stored in a single folder called the "ArchiveBox data folder". All `archivebox` CLI commands must be run from inside this folder, and you first create it by running `archivebox init`.
+The on-disk layout is optimized to be easy to browse by hand and durable long-term. The main index is a standard `index.sqlite3` database in the root of the data folder (it can also be exported as static JSON/HTML), and the archive snapshots are organized by date-added timestamp in the `./archive/` subfolder.
+
+```bash
+tree .
+./
+ index.sqlite3
+ ArchiveBox.conf
+ archive/
+ ...
+ 1617687755/
+ index.html
+ index.json
+ screenshot.png
+ media/some_video.mp4
+ warc/1617687755.warc.gz
+ git/somerepo.git
+ ...
+```
+
+Each snapshot subfolder `./archive//` includes a static `index.json` and `index.html` describing its contents, and the snapshot extrator outputs are plain files within the folder.
+
+
+
+## Output formats
+
+Inside each Snapshot folder, ArchiveBox save these different types of extractor outputs as plain files:
+
+`./archive//