diff --git a/cookbook/security/form_login.rst b/cookbook/security/form_login.rst
index dcae87bddc7..9687666175f 100644
--- a/cookbook/security/form_login.rst
+++ b/cookbook/security/form_login.rst
@@ -42,6 +42,7 @@ Form Login Configuration Reference
                         # login failure redirecting options (read further below)
                         failure_path:                   null
                         failure_forward:                false
+                        failure_target_path:            _failure_path
 
                         # field names for the username and password fields
                         username_parameter:             _username
@@ -66,6 +67,7 @@ Form Login Configuration Reference
                     use_referer="false"
                     failure_path="null"
                     failure_forward="false"
+                    failure_target_path="_failure_path"
                     username_parameter="_username"
                     password_parameter="_password"
                     csrf_parameter="_csrf_token"
@@ -90,6 +92,7 @@ Form Login Configuration Reference
                     'use_referer'                    => false,
                     'failure_path'                   => null,
                     'failure_forward'                => false,
+                    'failure_target_path'            => _failure_path,
                     'username_parameter'             => '_username',
                     'password_parameter'             => '_password',
                     'csrf_parameter'                 => '_csrf_token',
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 86e7670d078..f04c064be72 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -120,6 +120,7 @@ Each part will be explained in the next section.
                         use_referer: false
                         failure_path: /foo
                         failure_forward: false
+                        failure_path_parameter: _failure_path
                         failure_handler: some.service.id
                         success_handler: some.service.id
                         username_parameter: _username