Overview

This article explains how to configure your link settings in Branch. The Link Controls page allows you to manage link domains, customize link appearance, and configure routing rules for different platforms and devices.

To access these settings, go to Configuration > Link Controls in Branch. To change them, you need Edit access to App-level Settings.

The Link Controls page contains two tabs:

• Link Appearance - Configure your link domains, social media previews, and QR code styling.
• Link Routing Rules - Configure where users are redirected based on their platform and device.

The Link Appearance tab contains settings for how your links look and which domains they use.

Link domains

Use custom domains to brand your short links. This section displays your default domain, custom domains, and Branch-provided deep linking domains.

Default domain

The default domain is used for all new links created in your Branch app. If you have more than one custom domain, you can make any of them the default.

To change your default domain:

1. Select Change Default Domain.
2. Select a domain from the Available Domains dropdown.
3. Select Save Changes.

Custom domains

You can add custom domains to brand your Branch Links with your own domain name. The Custom Domains section appears only when custom domains are turned on for your account.

Before you add a custom domain, point its DNS to Branch:

• For a subdomain like link.yourbrand.com, point it to custom.bnc.lt with a CNAME record in your DNS provider.
• For a root domain like yourbrand-link.com, set its NS records to these nameservers:
  • ns-1581.awsdns-05.co.uk
  • ns-234.awsdns-29.com
  • ns-1059.awsdns-04.org
  • ns-843.awsdns-41.net

To add a custom domain:

1. Select Add a Custom Domain.
2. Enter your custom domain in the field provided. Branch checks the domain's DNS as you type and shows an error if it isn't ready.
3. Select Save Domain.

To remove a custom domain, select the delete icon next to it, then select Confirm Delete. You can't undo a removal, and every link that uses the domain stops redirecting.

Deep linking domains

These are your Branch-provided deep linking domains. Ask your app developer to configure Universal Links and Android App Linking for these domains.

Branch provides you with a primary deep linking domain and an alternate domain. When deep linking isn't turned on for your account, this section is called Branch-Provided Domain and shows only the primary domain.

You can change the subdomain only from your live app, not your test app. A subdomain can be up to 19 characters, using lowercase letters, numbers, and hyphens. It can't end in -web or -alternate, and Branch also checks that the subdomain is available.

To change your Branch deep linking subdomain:

1. Select Change App.link Domain.
2. Enter your new subdomain in the field provided.
3. Select Confirm Change.

Caution

Changing a subdomain will result in all links currently using that subdomain not redirecting properly. Make sure to update your mobile app to use the new subdomain after making this change.

Link preview

Configure how your link will look by default when shared on social platforms. You can customize this per individual link during link creation.

To configure the default link preview:

1. Select Configure in the Link Preview section.
2. Enter a Title for your link preview.
3. Enter a Description for your link preview.
4. Add a thumbnail image by uploading a file or entering an image URL.
5. Select Save Changes.

Note

These settings will be used as defaults for new links. You can still customize individual link previews when creating links.

QR code

Configure your default QR code design. This will apply to all short links created in Branch or via the QR Code API. You can also customize each individual QR code during creation.

To configure the default QR code design:

1. Select Configure in the QR Code section.

2. Select your styles:

   • Choose a pattern - Select from available QR code pattern styles
   • Choose a finder - Select the style for the corner finder patterns
   • Choose a shape - Select a square or circular shape
   • Add a border - Toggle to add a border around your QR code

3. Select your colors:

   • Choose from preset colors or enter custom hex values
   • Code Color - The color of the QR code modules
   • Finder Color - The color of the corner finder patterns
   • Background Color - The background color of the QR code

4. (Optional) Add a logo by uploading a file or entering an image URL.

5. Select Save Changes.

The Configure buttons for link previews and QR codes appear only when those features are turned on for your account.