Brand Singular links with your domain

Branded Domains allows you to fully brand Singular links using your own domain and subdomain, creating a seamless, trusted experience for your users. Instead of the standard "company.sng.link", you can use "link.yourbrand.com".

Why Use a Branded Domain?

• Strengthen your brand: Keep every touchpoint fully branded.
• Boost user trust: Branded domains improve credibility and click-through rates.
• Increase engagement: Clean, recognizable URLs perform better in social and SMS campaigns.
• Maintain analytics power: Enjoy full Singular tracking with your brand front and center.

Step 1: Create and Configure Your Domain

You can now manage and automate your branded domains directly within the Singular platform under Manage Link Domains.

1. Create Domain: Click the "Create Links Domain" button in the "Manage Domains" tab. Select "Branded" as the domain type and enter your desired subdomain (e.g., link.mybrand.com). Click Save.

2. DNS Configuration: Once saved, the domain status will show as Pending. Click the "Pending DNS Configuration" dropdown to reveal your CNAME records.

   Provide the Host/Name and Target values to your IT team to add to your DNS settings.

3. Validation: After your IT team updates the DNS (which can take up to 24 hours), click Validate. Once validated, Singular will begin Creating Certificate. This process is automated but can take some time to complete.

Step 2: Update Your SDK Integration

To ensure proper tracking and deep linking, you must update your Singular SDK integration. This allows the SDK to recognize your custom domain when the app is opened.

1. Update App Capabilities

iOS: Navigate to Project settings Capabilities Associated Domains and add your branded domain (e.g., applinks:link.mybrand.com). 

Android: Add an intent filter to your AndroidManifest.xml to handle the new host:

<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 the custom domain in your Singular Config prior to initializing the SDK:

iOS (Objective-C):

SingularConfig* config = [[SingularConfig alloc] initWithApiKey:apiKey andSecret:secretKey];
config.brandedDomains = @[@"link.mybrand.com"];

Android (Java):

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

Step 3: Go Live

Once the status in the dashboard changes to ● Active, your branded domain is ready. It will now appear as an option in the Link Management dropdown when creating new tracking links.

Need Help?

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