diff --git a/cookbook/email/gmail.rst b/cookbook/email/gmail.rst index 6a64a82e1ea..9f925cad224 100644 --- a/cookbook/email/gmail.rst +++ b/cookbook/email/gmail.rst @@ -75,3 +75,13 @@ You're done! The ``gmail`` transport is simply a shortcut that uses the ``smtp`` transport and sets ``encryption``, ``auth_mode`` and ``host`` to work with Gmail. + +.. note:: + + Depending on your Gmail account settings, you may get authentication errors + within your app. If your Gmail account uses 2-Step-Verification, you should + `generate an App password`_ to use for your ``mailer_password`` parameter. + You should also ensure that you `allow less secure apps to access your Gmail account`_. + +.. _`generate an App password`: https://support.google.com/accounts/answer/185833 +.. _`allow less secure apps to access your Gmail account`: https://support.google.com/accounts/answer/6010255