diff --git a/src/ui/public/field_editor/field_editor.html b/src/ui/public/field_editor/field_editor.html
index 7de9ded73ada5..f0d70a5e1388e 100644
--- a/src/ui/public/field_editor/field_editor.html
+++ b/src/ui/public/field_editor/field_editor.html
@@ -136,6 +136,9 @@ <h4>
           <i class="fa fa-question-circle text-info"></i> Scripting Help
         </h4>
 
+        <h5>
+	  Painless:
+	</h5>
         <p>
           By default, Kibana scripted fields use <a target="_window" ng-href="{{editor.docLinks.painless}}">Painless <i class="fa-link fa"></i></a>, a simple and secure scripting language designed specifically for use with Elasticsearch.  To access values in the document use the following format:
         </p>
@@ -146,6 +149,11 @@ <h4>
           Painless is powerful but easy to use. It provides access to many <a target="_window" ng-href="{{editor.docLinks.painlessApi}}">native Java APIs <i class="fa-link fa"></i></a>. Read up on its <a target="_window" ng-href="{{editor.docLinks.painlessSyntax}}">syntax <i class="fa-link fa"></i></a> and you'll be up to speed in no time!
         </p>
 
+        <p>
+          Sorting, aggregations, and <strong>access to field values in scripts</strong> require doc values which are supported (and on by default) on almost all field types, with the notable exception of analyzed string fields.
+	  You can check the Fields tab to make sure the fields you want to use in your scripts are aggregatable and not analyzed before using them in a script.
+        </p>
+
         <p>
           Kibana currently imposes one special limitation on the scripts you write. Your scripts must consist of a single expression. Multi-statement scripts with an explicit return statement will not work.
           In other words, the above example is a valid script, but something like the following is not.
@@ -159,6 +167,9 @@ <h4>
           </code>
         </p>
 
+        <h5>
+	  Expression:
+	</h5>
         <p>
           Coming from an older version of Kibana? The <a target="_window" ng-href="{{editor.docLinks.luceneExpressions}}">Lucene Expressions <i class="fa-link fa"></i></a> you know and love are still available. Lucene expressions are a lot like JavaScript, but limited to basic arithmetic, bitwise and comparison operations.
         </p>