diff --git a/src/typeahead/docs/readme.md b/src/typeahead/docs/readme.md
index 22fcf0ba8e..6c6ce507e1 100644
--- a/src/typeahead/docs/readme.md
+++ b/src/typeahead/docs/readme.md
@@ -9,4 +9,42 @@ It is very well integrated into the AngularJS as it uses subset of the
 
 The `sourceArray` expression can use a special `$viewValue` variable that corresponds to a value entered inside input by a user.
 
-Also this directive works with promises and it means that you can retrieve matches using the `$http` service with minimal effort.
\ No newline at end of file
+Also this directive works with promises and it means that you can retrieve matches using the `$http` service with minimal effort.
+
+The typeahead directives provide several attributes:
+
+* `ng-model` <i class="icon-eye-open"></i>
+   :
+   Assignable angular expression to data-bind to
+
+* `typeahead` <i class="icon-eye-open"></i>
+   :
+   Comprehension Angular expression (see [select directive](http://docs.angularjs.org/api/ng.directive:select))
+
+* `typeahead-editable` <i class="icon-eye-open"></i>
+   _(Defaults: false)_ :
+   Should it restrict model values to the ones selected from the popup only ?
+
+* `typeahead-input-formatter` <i class="icon-eye-open"></i>
+   _(Defaults: undefined)_ :
+   Format the ng-model result after selection
+
+* `typeahead-loading` <i class="icon-eye-open"></i>
+   _(Defaults: angular.noop)_ :
+   Binding to a variable that indicates if matches are being retrieved asynchronously
+
+* `typeahead-min-length` <i class="icon-eye-open"></i>
+   _(Defaults: 1)_ :
+   Minimal no of characters that needs to be entered before typeahead kicks-in
+
+* `typeahead-on-select` <i class="icon-eye-open"></i>
+   _(Defaults: null)_ :
+   A callback executed when a match is selected
+
+* `typeahead-template-url` <i class="icon-eye-open"></i>
+   :
+   Set custom item template
+
+* `typeahead-wait-ms` <i class="icon-eye-open"></i>
+   _(Defaults: 0)_ :
+   Minimal wait time after last character typed before typehead kicks-in