diff --git a/src/accordion/docs/readme.md b/src/accordion/docs/readme.md
index 5b3ae93b39..5ead8c18ec 100644
--- a/src/accordion/docs/readme.md
+++ b/src/accordion/docs/readme.md
@@ -2,4 +2,8 @@ The **accordion directive** builds on top of the collapse directive to provide a
 
 We can control whether expanding an item will cause the other items to close, using the `close-others` attribute on accordion.
 
-The body of each accordion group is transcluded in to the body of the collapsible element.
\ No newline at end of file
+The body of each accordion group is transcluded in to the body of the collapsible element.
+
+### Accordion Settings ###
+
+`is-open` <i class="glyphicon glyphicon-eye-open"></i> (Defaults: false) : Whether group is open or closed.