diff --git a/docs/badge/sdcard.rst b/docs/badge/sdcard.rst
new file mode 100644
index 0000000000000000000000000000000000000000..6161139ac11e73b975a699b5fa2d931e7fbe832d
--- /dev/null
+++ b/docs/badge/sdcard.rst
@@ -0,0 +1,18 @@
+SD Card
+-------
+
+There's a microSD card slot on the inner side of the badge.
+
+There's no first-class firmware support for it yet, but you can mount it in the
+micropython VFS with:
+
+.. code-block:: python
+
+   import machine, os
+   sdcard = machine.SDCard(clk=47, cmd=48, d0=21)
+   os.mount(sdcard, "/sd")
+
+Filesystem support is provided by `FatFs
+<http://elm-chan.org/fsw/ff/00index_e.html>` which claims to support
+FAT16/32/exFAT. TODO: test
+
diff --git a/docs/index.rst b/docs/index.rst
index fd39b426955584908a8ead960d334f8514f6ebe7..92eeede97456320158e9113d18db4994e5acd2ae 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -12,6 +12,7 @@ Welcome to flow3r's documentation!
 
    badge/hardware_specs.rst
    badge/badge_link.rst
+   badge/sdcard.rst
 
 .. toctree::
    :maxdepth: 1