diff --git a/cmd/server/assets/mobileapps/_app.html b/cmd/server/assets/mobileapps/_app.html
index a5e55bc35..faac35a17 100644
--- a/cmd/server/assets/mobileapps/_app.html
+++ b/cmd/server/assets/mobileapps/_app.html
@@ -32,6 +32,7 @@
   <small class="form-text text-muted d-none" id="ioshelp">
     The iOS Mobile App configuration must be blank if you are an iOS Exposure Notifications Express (ENX) customer. This should only
     be filled in for custom applications.
+    The iOS app id should be either a team ID or app ID prefix followed by the bundle ID. eg. ABCD1234.com.google.test.application
   </small>
 </div>
 
diff --git a/docs/link_handling.md b/docs/link_handling.md
index 08da0fef7..1ed5d5128 100644
--- a/docs/link_handling.md
+++ b/docs/link_handling.md
@@ -48,7 +48,7 @@ Sample iOS universal link metadata
 	"applinks": {
 		"details": [
 			{
-				"appID": "com.google.test.application",
+				"appID": "ABCD1234.com.google.test.application",
 				"paths": ["*"]
 			}
 		]
diff --git a/pkg/controller/associated/ios.go b/pkg/controller/associated/ios.go
index fb5ee2023..01d007250 100644
--- a/pkg/controller/associated/ios.go
+++ b/pkg/controller/associated/ios.go
@@ -78,6 +78,7 @@ func (c *Controller) getIosData(realmID uint) (*IOSData, error) {
 
 	return &IOSData{
 		Applinks: Applinks{
+			Apps:    []string{}, // expected always empty.
 			Details: details,
 		},
 	}, nil
diff --git a/pkg/database/mobile_app.go b/pkg/database/mobile_app.go
index f42fa5410..5e92880e0 100644
--- a/pkg/database/mobile_app.go
+++ b/pkg/database/mobile_app.go
@@ -67,6 +67,9 @@ type MobileApp struct {
 	OS OSType `gorm:"column:os; type:int;"`
 
 	// AppID is a unique string representing the app.
+	//
+	// For iOS this should include the team ID or app ID prefix followed by
+	// the bundle ID. eg. ABCD1234.com.google.test.application
 	AppID string `gorm:"column:app_id; type:varchar(512);"`
 
 	// SHA is a unique hash of the app.