WarpLink
Migration

Firebase Dynamic Links Migration

A step-by-step guide to migrate from Firebase Dynamic Links to WarpLink, including link mapping, SDK setup, and attribution.

Firebase Dynamic Links was deprecated on August 25, 2025. Existing links will eventually stop working. Migrate now to avoid disruption.

Concept Mapping

Firebase Dynamic LinksWarpLink
Dynamic LinksLinks
Firebase consoleWarpLink dashboard
yourapp.page.link domainaplnk.to domain (or custom domain)
Link parameters (social metadata)Link fields + OG tags
Firebase Analytics integrationBuilt-in click analytics + attribution

Recreate your Firebase Dynamic Links in WarpLink via the dashboard or REST API.

Parameter Mapping

Firebase ParameterWarpLink Field
link (deep link URL)destination_url
isi / apn (app identifiers)Configured per-app in dashboard
ifl / afl (fallback links)ios_fallback_url / android_fallback_url
efr (skip preview page)N/A (WarpLink uses 302 redirects by default)
st / sd / si (social metadata)og_title / og_description / og_image_url
Custom parameterscustom_params JSON object

Create via API

2. Swap the SDK

Remove Firebase:

  1. Remove FirebaseCore and FirebaseDynamicLinks packages from Xcode
  2. Remove FirebaseApp.configure() (unless you use other Firebase services)
  3. Remove import FirebaseCore and import FirebaseDynamicLinks

Add WarpLink:

Remove Firebase:

Add WarpLink:

Remove Firebase:

Add WarpLink:

3. Update SDK Initialization

Before (Firebase):

After (WarpLink):

Before (Firebase):

After (WarpLink):

Before (Firebase):

After (WarpLink):

4. Update Domain Configuration

In Signing & Capabilities > Associated Domains:

In AndroidManifest.xml, update the intent filter host:

Before (Firebase):

After (WarpLink):

Before (Firebase):

After (WarpLink):

Before (Firebase):

After (WarpLink):

Before (Firebase):

After (WarpLink):

Before (Firebase):

After (WarpLink):

Before (Firebase):

After (WarpLink):

FeatureFirebaseWarpLink
Deferred detectionNo isDeferred flaglink.isDeferred === true
Attribution dataNonematchType, matchConfidence
Match confidenceNot available0.0–1.0 score
CachingManualAutomatic (once per install)
Matching methodPlay Install Referrer onlyReferrer + IDFV + fingerprint

7. API Migration

Firebase REST APIWarpLink REST API
POST https://firebasedynamiclinks.googleapis.com/v1/shortLinksPOST https://api.warplink.app/v1/links
API key as query parameterBearer token in Authorization header
dynamicLinkInfo objectFlat JSON body

Feature Comparison

FeatureFirebase Dynamic LinksWarpLink
Short linksYesYes
Deferred deep linksYes (limited)Yes (with confidence scores)
Install attributionNoYes (deterministic + probabilistic)
Custom domainsYesYes
Social previewsBuilt-inBuilt-in (bot detection + OG tags)
Open source SDKNoYes (MIT license)
PricingFree (deprecated)Free tier (10K clicks/mo)

Testing Checklist

After migration, verify on each platform:

  • SDK initializes — enable debug logging and check console output
  • Deep links open the app — tap a WarpLink URL on a physical device
  • Deep link data resolves — destination and custom parameters are correct
  • Deferred deep links work — uninstall, click link, reinstall, verify match
  • AASA/assetlinks verified — curl https://aplnk.to/.well-known/apple-app-site-association
  • Error handling — test invalid URLs, expired links, no connectivity
  • All Firebase code removed — no remaining imports or dependencies
  • Clean build — no compilation errors

On this page