diff --git a/docs/version-7-upgrade.md b/docs/version-7-upgrade.md
index 8651f50ac..8bfc39041 100644
--- a/docs/version-7-upgrade.md
+++ b/docs/version-7-upgrade.md
@@ -296,3 +296,31 @@ export class Foo {
     }
 }
 ```
+### Changes to Auth
+on ios native, provideAuth() needs to initializeAuth() first:
+```
+import {
+  getAuth,
+  indexedDBLocalPersistence,
+  initializeAuth,
+  provideAuth,
+} from '@angular/fire/auth';
+
+@NgModule({
+  declarations: [AppComponent],
+  entryComponents: [],
+  imports: [
+    ...
+    provideAuth(() => {
+      if (Capacitor.isNativePlatform()) {
+        return initializeAuth(getApp(), {
+          persistence: indexedDBLocalPersistence,
+        });
+      } else {
+        return getAuth();
+      }
+    }),
+  ]
+})
+
+```