From 4e42d5185bf626bbe9bf0b3980170163cd2804ea Mon Sep 17 00:00:00 2001
From: TC <86952204+roti-c137@users.noreply.github.com>
Date: Sat, 25 Jun 2022 06:45:34 +0800
Subject: [PATCH] docs(messaging, ios): add Background App Refresh / message
 handler interaction note

---
 docs/messaging/usage/index.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/messaging/usage/index.md b/docs/messaging/usage/index.md
index 103991b3ed..60bb9c333b 100644
--- 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.