diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 0a3aaebd6e6..bac3337ac73 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -62,11 +62,24 @@ Each part will be explained in the next section.
                     hash_algorithm:       sha512
                     encode_as_base64:     true
                     iterations:           1000
+                    key_length:           40
 
                 # Example options/values for what a custom encoder might look like
                 Acme\DemoBundle\Entity\User3:
                     id:                   my.encoder.id
 
+                # BCrypt encoder
+                # see the note about bcrypt below for details on specific dependencies
+                Acme\DemoBundle\Entity\User4:
+                    algorithm:            bcrypt
+                    cost:                 13
+
+                # Plaintext encoder
+                # it does not do any encoding
+                Acme\DemoBundle\Entity\User5:
+                    algorithm:            plaintext
+                    ignore_case:          false
+
             providers:            # Required
                 # Examples:
                 my_in_memory_provider: