Skip to content

Changing Link Domains

    • Go to Link Settings on the Branch Dashboard

    • Use custom subdomain
    • Use custom root domain
      • Understand Domain change warning
      • Understand Custom domain warning
      • Understand Custom domain debugging
      • Change your link domain to your custom root domain on Link settings
      • Update your NS records on your custom root domain
        • These values are unique per app, below is an example
          • ns-1371.awsdns-43.org
          • ns-1695.awsdns-19.co.uk
          • ns-991.awsdns-59.net
          • ns-428.awsdns-53.com
      • Click Confirm on Link settings
      • If you are configuring the domain through AWS's Route 53, make sure you are editing the nameservers under the Registered Domains tab, and not the Hosted zones section

Troubleshoot issues

  • Domain change warning

    • Used for Change link domain
    • From app.link to app.link
      • Your old app.link deep links will fail
      • Your old app.link deep links will navigate to a File Not Found website and not open your app.
      • Your new app.link deep links will open your app after your update your code to append the new link domain
      • If your old app.link are active, it is recommend to switch to a custom link domain instead
    • From app.link to custom link domain
      • Your old app.link deep links will still work
      • Your new custom link domain deep links will open your app after your update your code to append the new link domain
    • From custom link domain to custom link domain
      • Your old custom link domain deep links will fail
      • Your new custom link domain deep links will open your app after your update your code to append the new link domain
    • From legacy bnc.lt to custom link domain
      • Both your bnc.lt and custom link domain deep links will work
      • Your new custom link domain deep links will open your app after your update your code to append the new link domain
  • Custom domain warning

    • Used for Change link domain
    • The NS or CNAME records of your custom link domain will need to point to Branch if you want to use your own domain for your deep links
    • Whenever you change your NS or CNAME records of a domain, you are making Branch the authoritative registrar for your domain. This will grant Branch control of your domain and you will lose all access to that custom root domain or custom subdomain. The web page will become blank, and the control of the domain will change to Branch
    • Branch will use your domain to route all deep linked traffic. Branch will also host your AASA file and SSL certificates
    • If you have content on your custom root domain (e.g. https://example.com/), Branch recommends using an unused custom subdomain instead (e.g. https://link.example.com/)
  • Custom domain debugging

    • Used for Change link domain
    • You can test your domain record changes with dig ns <domain> or dig cname <domain>
    • We recommend that you choose one domain or subdomain to use with Branch and stick with it, as switching can cause significant problems with your existing links
    • If you are configuring the domain through AWS's Route 53, make sure you are editing the nameservers under the Registered Domains tab, and not the Hosted zones section
    • You cannot use your main website domain for hosting Branch links
    • Do not include www when adding your custom link domain
    • If you have CAA records set for your domain, add letsencrypt.org to the list
  • App Deletion

If you navigate to Account Settings, and choose to delete your app, this will be a permanent change. Note the following actions that we apply once you delete your Branch app.

- We delete the dashboard user data of the original app creator associated with that particular app. They can still log in to other apps.
- Your links will show a 404.
- All requests to our API (via the SDK), will return a server error.
- Attribution and analytics infromation will no longer be tracked.
- All data feed systems will stop sending data (such as webhooks and data integrations).