diff --git a/src/content/cookbook/navigation/set-up-app-links.md b/src/content/cookbook/navigation/set-up-app-links.md
index d91625a869..af5e80210e 100644
--- a/src/content/cookbook/navigation/set-up-app-links.md
+++ b/src/content/cookbook/navigation/set-up-app-links.md
@@ -96,17 +96,29 @@ It provides a simple API to handle complex routing scenarios.
```
-
+
+ :::version-note
+ If you use a Flutter version earlier than 3.27,
+ you need to manually opt in to deep linking by
+ adding the following metadata tag to ``:
+
+ ```xml
+
+ ```
+ :::
+
:::note
If you use a third-party plugin to handle deep links,
- such as [app_links][],
+ such as [app_links][],
Flutter's default deeplink handler will
- break these plugins.
-
+ break these plugins.
+
To opt out of using Flutter's default deep link handler,
- add the following metadata tag:
- ``````
- to opt out of Flutter's default deeplink handler
+ add the following metadata tag to ``:
+
+ ```xml
+
+ ```
:::
## 3. Hosting assetlinks.json file
diff --git a/src/content/cookbook/navigation/set-up-universal-links.md b/src/content/cookbook/navigation/set-up-universal-links.md
index 604f1ffa0e..87fe90fb70 100644
--- a/src/content/cookbook/navigation/set-up-universal-links.md
+++ b/src/content/cookbook/navigation/set-up-universal-links.md
@@ -82,15 +82,21 @@ It provides a simple API to handle complex routing scenarios.
1. Open the `ios/Runner.xcworkspace` file inside the
Flutter project's `ios` folder.
- :::note
- If you are using third-party plugins to handle deep links,
- such as [app_links][],
- Flutter's default deeplink handler will
- break these plugins.
-
- If you use a third-party plugin,
- add the key and value pair `FlutterDeepLinkingEnabled` and `NO` to info.Plist.
- :::
+ :::version-note
+ If you use a Flutter version earlier than 3.27,
+ you need to manually opt in to deep linking by adding the
+ key and value pair `FlutterDeepLinkingEnabled` and `YES` to `info.Plist`.
+ :::
+
+ :::note
+ If you're using third-party plugins to handle deep links,
+ such as [app_links][],
+ Flutter's default deeplink handler will
+ break these plugins.
+
+ If you use a third-party plugin, add the
+ key and value pair `FlutterDeepLinkingEnabled` and `NO` to `info.Plist`.
+ :::
### Add associated domains