From 659324090d4ab8823b711bbebb43be5eda480ced Mon Sep 17 00:00:00 2001
From: Daniel Montano <daniel@embusinessproducts.com>
Date: Fri, 10 Jul 2020 12:18:03 -0400
Subject: [PATCH] docs(links): add instructions on setting up Xcode for dynamic
 links with custom domains (#3923)

Co-authored-by: Mike Hardy <github@mikehardy.net>
---
 docs/dynamic-links/usage/index.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/docs/dynamic-links/usage/index.md b/docs/dynamic-links/usage/index.md
index 62dd2825..ecd38c15 100644
--- a/docs/dynamic-links/usage/index.md
+++ b/docs/dynamic-links/usage/index.md
@@ -70,6 +70,31 @@ To setup Dynamic Links on iOS, it is a **prerequisite** that you have an Apple d
 
 ![iOS dynamic link fifth step](https://images.prismic.io/invertase/cb029ba6-ad40-494e-a3f6-2aacaff494d1_Screenshot+2020-05-07+at+10.16.16.png?auto=compress,format)
 
+### Dynamic Links With Custom Domains
+
+If you have set up a [custom domain](https://firebase.google.com/docs/dynamic-links/custom-domains) for your Firebase project, you must add the dynamic link URL prefix into your iOS project's `info.plist` file by using the  `FirebaseDynamicLinksCustomDomains` key. You can add multiple URLs as well.
+
+Example:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>FirebaseDynamicLinksCustomDomains</key>
+  <array>
+    <string>https://custom.domain.io/bla</string>
+    <string>https://custom.domain.io/bla2</string>
+  </array>
+  
+  ...other settings
+  
+</dict>
+</plist>
+```
+
+If you don't add this, the dynamic link will invoke your app, but you cannot retrieve any deep link data you may need within your app, as the deep link will be completely ignored.
+
 ## iOS Testing Your Dynamic Link
 
 To test your dynamic link, you will need to use a real device as it will not work on a simulator.