diff --git a/src/guide/migration/custom-directives.md b/src/guide/migration/custom-directives.md
index 6b5a3656c7..ad5d45a9dc 100644
--- a/src/guide/migration/custom-directives.md
+++ b/src/guide/migration/custom-directives.md
@@ -9,6 +9,8 @@ badges:
 
 The hook functions for directives have been renamed to better align with the component lifecycle.
 
+Additionally, the `expression` string is no longer passed as part of the `binding` object.
+
 ## 2.x Syntax
 
 In Vue 2, custom directives were created by using the hooks listed below to target an element’s lifecycle, all of which are optional:
diff --git a/src/guide/migration/introduction.md b/src/guide/migration/introduction.md
index 082c7f64f6..850a92701a 100644
--- a/src/guide/migration/introduction.md
+++ b/src/guide/migration/introduction.md
@@ -100,7 +100,7 @@ The following consists a list of breaking changes from 2.x:
 - The `destroyed` lifecycle option has been renamed to `unmounted`
 - The `beforeDestroy` lifecycle option has been renamed to `beforeUnmount`
 - [Props `default` factory function no longer has access to `this` context](/guide/migration/props-default-this.html)
-- [Custom directive API changed to align with component lifecycle](/guide/migration/custom-directives.html)
+- [Custom directive API changed to align with component lifecycle and `binding.expression` removed](/guide/migration/custom-directives.html)
 - [The `data` option should always be declared as a function](/guide/migration/data-option.html)
 - [The `data` option from mixins is now merged shallowly](/guide/migration/data-option.html#mixin-merge-behavior-change)
 - [Attributes coercion strategy changed](/guide/migration/attribute-coercion.html)