diff --git a/source/_docs/configuration/packages.markdown b/source/_docs/configuration/packages.markdown
index fd63ddde23d..010f4bd5e2b 100644
--- a/source/_docs/configuration/packages.markdown
+++ b/source/_docs/configuration/packages.markdown
@@ -112,3 +112,12 @@ It is possible to [customize entities](/docs/configuration/customizing-devices/)
 homeassistant:
   customize:
 ```
+
+
+<div class='note warning'>
+
+If you are moving configuration to packages, `auth_providers` must stay within ‘configuration.yaml’. See the general documentation for [Authentication Providers](/docs/authentication/providers/#configuring-auth-providers).
+
+This is because Home Assistant processes the authentication provided early in the start-up process, even before packages are processed.
+
+</div>