docs(messaging, ios): add Background App Refresh / message handler in…

…teraction note
invertase · Jun 24, 2022 · 4e42d51 · 4e42d51 · vercel · Jun 24, 2022
1 parent 66e6fb0
commit 4e42d51
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/docs/messaging/usage/index.md b/docs/messaging/usage/index.md
@@ -311,6 +311,12 @@ messaging()
 
 On Android, the `isHeadless` prop will not exist.
 
+#### iOS Background Limitation
+
+On iOS devices, the user is able to toggle Background App Refresh in device's Settings. Furthermore, the Background App Refresh setting will automatically be off if the device is in low power mode.
+
+If the iOS Background App Refresh mode is off, your handler configured in `setBackgroundMessageHandler` will not be triggered.
+
 ### Topics
 
 Topics are a mechanism which allow a device to subscribe and unsubscribe from named PubSub channels, all managed via FCM.