diff --git a/README.md b/README.md
index a70e100..8184ff8 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,35 @@ To install all node dependencies, run (do this once):
 
 See [config/default.json](config/default.json). Set `storage_local_path` for a local sqlite database or `storage_region`, `storage_bucket`, `storage_cdn` and `storage_endpoint` for AWS S3. `mail_provider` may be one of `console` or `smtp`. Also, omit a trailing `/` for the `endpoint`.
 
+## Configure color swatches
+
+Add a custom array of swatches to your config/default.json. 
+**You need to include black (#000000) and transparent (rgba(0,0,0,0)) in your custom swatches palette.**
+
+```json
+...
+"spacedeck": {
+    "swatches": [
+      {"id":8, "hex":"#000000"},
+      {"id":30, "hex":"rgba(0,0,0,0)"},
+      {"id":31, "hex": "#E11F26"},
+      {"id":32, "hex": "#9E0F13"},
+      {"id":33, "hex": "#64BCCA"},
+      {"id":34, "hex": "#40808A"},
+      {"id":35, "hex": "#036492"},
+      {"id":36, "hex": "#005179"},
+      {"id":37, "hex": "#84427E"},
+      {"id":38, "hex": "#6C3468"},
+      {"id":39, "hex": "#F79B84"},
+      {"id":40, "hex": "#B57362"},
+      {"id":41, "hex": "#E7D45A"},
+      {"id":42, "hex": "#ACA044"}
+    ]
+  }
+}
+...
+```
+
 # Run (web server)
 
     node spacedeck.js