diff --git a/docs/supported.rst b/docs/supported.rst
index 1463e28..d469543 100644
--- a/docs/supported.rst
+++ b/docs/supported.rst
@@ -114,6 +114,21 @@ iCloud
 Vdirsyncer is irregularly tested against iCloud_. There are no known issues
 with it.
 
+::
+
+    [storage cal]
+    type = caldav
+    url = https://caldav.icloud.com/
+    username = ...
+    password = ...
+
+    [storage card]
+    type = carddav
+    url = https://contacts.icloud.com/
+    username = ...
+    password = ...
+
+
 .. _iCloud: http://icloud.com/
 
 DavMail (Exchange, Outlook)