diff --git a/dashboards/Readme.md b/dashboards/Readme.md
new file mode 100644
index 0000000000000000000000000000000000000000..8af71a821ac40cf3e3cc7cd66a5a94609dca227b
--- /dev/null
+++ b/dashboards/Readme.md
@@ -0,0 +1,14 @@
+## Dashboard
+
+Any `*.ipynb` file is recognized as a dashboard.
+
+**DO not put space in the dashboard name, see metadata**
+
+### Images
+
+Just put a `.png`, `.jpg` or `.svg` image with the same name as your dashboard without `.ipynb` to set it's cover image the image will be 232*232 pixels
+
+### Metadata
+
+
+Edit the `metadata.json` to add title and description to your dashboards
diff --git a/dashboards/metadata.json b/dashboards/metadata.json
new file mode 100644
index 0000000000000000000000000000000000000000..7b4c0338a0195f4d86d9304486ff6fb98f11d003
--- /dev/null
+++ b/dashboards/metadata.json
@@ -0,0 +1,14 @@
+{
+    "Interactive_Voila": {
+        "title": "Interactive dashboards",
+        "description": "Some interactive dashboards with python callbacks"
+    },
+    "MonetDB": {
+        "title": "Monet DB",
+        "description": "A minimal Monet DB connexion example"
+    },
+    "csv": {
+        "title": "CSV reader",
+        "description": "A dashboard that's prints the contents of a CSV"
+    }
+}