Branded Domains: Brand Singular Links with Your Own Domain

Branded Domains lets you replace the standard company.sng.link tracking link domain with your own domain or subdomain — for example, link.yourbrand.com. The result is a fully branded, trusted link experience with no loss of Singular attribution power.

Why Use a Branded Domain?

• Strengthen your brand: Keep every touchpoint fully on-brand, from ad click to app open.
• Boost user trust: Branded domains increase credibility and click-through rates.
• Increase engagement: Clean, recognizable URLs perform better in social, email, and SMS campaigns.
• Maintain full analytics: You get the same Singular attribution data — just with your brand in the URL.

Domain Requirements

• Must be a subdomain of a domain you own (e.g., link.mybrand.com). Root domains (e.g., mybrand.com) are not supported.
• Must be a domain you can update DNS records for.
• The subdomain must not already be in use (e.g., pointing to another service).
• Special characters (such as -, $, !) are not supported in the subdomain label.
• Multi-level subdomains like x.y.mybrand.com are supported.

Step 1: Create and Configure Your Domain

Manage your branded domains in the Singular platform under Attribution > Manage Links > Manage Domains.

1. Create the Domain: Click Create Links Domain. Select Branded as the domain type and enter your desired subdomain (e.g., link.mybrand.com). Click Save.
2. Configure DNS: After saving, the domain status shows as Pending DNS Configuration. Click the dropdown to reveal your CNAME records.
   
   Provide the following values to your IT team to add to your DNS settings:

   DNS Record Type	Host / Name	Target / Value
   CNAME	(shown in Singular dashboard — specific to your domain)	(shown in Singular dashboard)

   Note: DNS propagation can take up to 24–48 hours. Do not click Validate until your IT team confirms the records are in place.

3. Validate: Once DNS is updated, click Validate in the Singular dashboard. Singular will verify the CNAME and begin Creating Certificate automatically via AWS ACM. This SSL provisioning step can take additional time.

Domain Status Lifecycle

Step 2: Update Your App Integration

To ensure proper deep linking and attribution with your branded domain, you must update your app and SDK configuration. This tells the app to recognize your custom domain when a link is opened.

1. Update App Capabilities

iOS — Add the domain to Associated Domains:

In Xcode, go to Project Settings > Signing & Capabilities > Associated Domains and add your branded domain:

applinks:link.mybrand.com

Android — Add an intent filter to AndroidManifest.xml:

Add a new <intent-filter> block for your branded domain alongside your existing sng.link entry:

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="http" />
    <data android:scheme="https" />
    <data android:host="link.mybrand.com" />
    <data android:host="example.sng.link" />
    <data android:pathPrefix="/A" />
    <data android:pathPrefix="/B" />
    <data android:pathPrefix="/E" />
    <data android:pathPrefix="/F" />
</intent-filter>

2. Update SDK Initialization

Register your branded domain in the SingularConfig object before initializing the SDK. This enables the SDK to handle deep links and deferred deep links arriving from your branded domain.

// Kotlin
val config = SingularConfig(apiKey, secretKey)
    .withBrandedDomains(listOf("link.mybrand.com"))

Singular.init(context, config)

// Java
SingularConfig config = new SingularConfig(apiKey, secretKey)
    .withBrandedDomains(Arrays.asList("link.mybrand.com"));

Singular.init(context, config);

// Swift
let config = SingularConfig(apiKey: apiKey, andSecret: secretKey)
config?.brandedDomains = ["link.mybrand.com"]
Singular.start(config)

// Objective-C
SingularConfig *config = [[SingularConfig alloc] initWithApiKey:apiKey andSecret:secretKey];
config.brandedDomains = @[@"link.mybrand.com"];
[Singular start:config];

SingularConfig config = new SingularConfig(apiKey, secretKey);
config.BrandedDomains = new List<string> { "link.mybrand.com" };
SingularSDK.InitializeSingular(config);

const config = new SingularConfig(apiKey, secretKey);
config.withBrandedDomains(["link.mybrand.com"]);
Singular.init(config);

final config = SingularConfig(apiKey, secretKey);
config.brandedDomains = ["link.mybrand.com"];
Singular.init(config);

const config = new SingularConfig(apiKey, secretKey);
config.brandedDomains = ["link.mybrand.com"];
singular.init(config);

Step 3: Go Live

Once the domain status changes to ● Active, your branded domain is ready. It will appear as a selectable option in the Link Management domain dropdown when you create new tracking links.

All new links created with the branded domain will use the structure:

https://link.mybrand.com/[APP_ID]/[LINK_ID]?[PARAMETERS]

Troubleshooting

Frequently Asked Questions

Need Help?

If you encounter issues during DNS validation, certificate provisioning, or SDK setup, contact your Customer Success Manager or reach out to Singular Support.