diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index fd3cc0fd576..b8301d7429e 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -300,6 +300,8 @@ The following block shows all possible configuration keys:
                 user:                 user
                 password:             secret
                 driver:               pdo_mysql
+                # if the url option is specified, it will override the above config
+                url:                  mysql://db_user:db_password@127.0.0.1:3306/db_name 
                 # the DBAL driverClass option
                 driver_class:         App\DBAL\MyDatabaseDriver
                 # the DBAL driverOptions option