# Deep link broken after routing change: pre-release checklist

Source: https://releasefailures.com/incidents/deep-link-broken-after-routing-change/
Content version: 1.0.0
Verified on: 2026-10-21
Licence: CC BY 4.0

Definition: Deep links or universal links open the wrong screen or nothing.
- [ ] PR-01 Before a domain migration, request the site association file on the old domain and confirm it is served directly with no redirect. (test class: Configuration and environment tests)
- [ ] PR-02 Confirm every domain in the app's associated domains list still serves its own site association file after the DNS provider change. (test class: Configuration and environment tests)
- [ ] PR-03 Run each change to the link redirection configuration against a list of sample links and their expected destinations before applying it. (test class: Configuration and environment tests)
- [ ] PR-04 Install the app fresh on an iOS device after the domain change, open a universal link from the old domain and confirm the app opens on the linked screen. (test class: End-to-end tests)
- [ ] PR-05 Open a sample deep link for each route and confirm it lands on the linked destination, not on the fallback domain or an error page. (test class: End-to-end tests)
- [ ] PR-06 Schedule a check that fetches the site association file from each associated domain without following redirects and alerts on any redirect response. (test class: Synthetic monitoring)
- [ ] PR-07 Schedule a check that resolves a sample deep link through the redirection service and alerts when the final destination is the fallback domain or an error page. (test class: Synthetic monitoring)
