diff --git a/src/components/sliders/attributes.js b/src/components/sliders/attributes.js
index f175aa50f57..8687c6728ad 100644
--- a/src/components/sliders/attributes.js
+++ b/src/components/sliders/attributes.js
@@ -24,7 +24,11 @@ var stepsAttrs = {
         dflt: 'restyle',
         role: 'info',
         description: [
-            'Sets the Plotly method to be called when the slider value is changed.'
+            'Sets the Plotly method to be called when the slider value is changed.',
+            'If the `skip` method is used, the API slider will function as normal',
+            'but will perform no API calls and will not bind automatically to state',
+            'updates. This may be used to create a component interface and attach to',
+            'slider events manually via JavaScript.'
         ].join(' ')
     },
     args: {
diff --git a/src/components/updatemenus/attributes.js b/src/components/updatemenus/attributes.js
index 2da8f3a85e6..3ffffdc5296 100644
--- a/src/components/updatemenus/attributes.js
+++ b/src/components/updatemenus/attributes.js
@@ -22,7 +22,11 @@ var buttonsAttrs = {
         dflt: 'restyle',
         role: 'info',
         description: [
-            'Sets the Plotly method to be called on click.'
+            'Sets the Plotly method to be called on click.',
+            'If the `skip` method is used, the API updatemenu will function as normal',
+            'but will perform no API calls and will not bind automatically to state',
+            'updates. This may be used to create a component interface and attach to',
+            'updatemenu events manually via JavaScript.'
         ].join(' ')
     },
     args: {