diff --git a/js/piwik.js b/js/piwik.js
index 21f5e2fd788bb1b3e929e2712356740916ba0800..c8235e2b4e2cae199a2e439d9b91c2c10b5d16e1 100644
--- a/js/piwik.js
+++ b/js/piwik.js
@@ -5375,8 +5375,8 @@ if (typeof window.Piwik !== 'object') {
                 },
 
                 /**
-                 * Set Custom Dimensions. Any set Custom Dimension will be cleared after a tracked pageview. Make
-                 * sure to set them again if needed.
+                 * Set Custom Dimensions. Set Custom Dimensions will not be cleared after a tracked pageview and will
+                 * be sent along all following tracking requests. It is possible to remove/clear a value via `deleteCustomDimension`.
                  *
                  * @param int index A Custom Dimension index
                  * @param string value