Manually constructing a Dynamic Link URL

You can create a Dynamic Link by manually constructing a URL with the following form:

https://app_code.app.goo.gl/?link=your_deep_link&apn=package_name[&amv=minimum_version][&al=android_link][&afl=fallback_link]

Dynamic Link parameters

Payload parameter
link

The link your app will open. You can specify a URL that your app can handle, typically an app's content/payload, which can initiate app-specific logic (such as crediting the user with a coupon or displaying a welcome screen). This link must be a well-formatted URL, be properly URL-encoded, use the HTTP or HTTPS, and not another Dynamic Link. scheme.

Android parameters
apn The package name of the Android app to use to open the link. The app must be connected to your project from the Overview page of the Firebase console. Required for the Dynamic Link to open an Android app.
afl The link to open when the app isn't installed. Specify this to do something other than install your app from the Play Store when the app isn't installed, such as open the mobile web version of the content, or display a promotional page for your app.
amv The versionCode of the minimum version of your app that can open the link. If the installed app is an older version, the user is taken to the Play Store to upgrade the app.
iOS parameters
ibi The bundle ID of the iOS app to use to open the link. The app must be connected to your project from the Overview page of the Firebase console. Required for the Dynamic Link to open an iOS app.
ifl The link to open when the app isn't installed. Specify this to do something other than install your app from the App Store when the app isn't installed, such as open the mobile web version of the content, or display a promotional page for your app.
ius Your app's custom URL scheme, if defined to be something other than your app's bundle ID
ipfl The link to open on iPads when the app isn't installed. Specify this to do something other than install your app from the App Store when the app isn't installed, such as open the web version of the content, or display a promotional page for your app.
ipbi The bundle ID of the iOS app to use on iPads to open the link. The app must be connected to your project from the Overview page of the Firebase console.
isi Your app's App Store ID, used to send users to the App Store when the app isn't installed
Desktop parameters
dfl The link to open on desktop, overriding param link. This is useful to specify a different behavior on desktop, like displaying mobile-web version of the app content/payload (as specified by param link) and suggesting users to install the app, which can be another dynamic link.
Social Meta Tag parameters
st The title to use when the Dynamic Link is shared in a social post.
sd The description to use when the Dynamic Link is shared in a social post.
si The URL to an image related to this link.
Analytics parameters
utm_source
utm_medium
utm_campaign
utm_term
utm_content
gclid
Google Play analytics parameters.
at
ct
mt
pt
iTunes Connect analytics parameters.

Debugging a URL

You can debug a Dynamic Link by taking a long or short URL and attaching a debug parameter.

https://abc123.app.goo.gl/?link=https://example.com&d=1
https://abc123.app.goo.gl/WXYZ?d=1
Debug parameter
d Instead of loading the Dynamic Link, generate a flowchart you can use to preview your Dynamic Links' behavior on different platforms and configurations.

Next steps

After you create a Dynamic Link, you need to set up your app to receive Dynamic Links and send users to the right place in your app after a user opens them.

To receive Dynamic Links in your app, see the documentation for iOS, Android, C++, and Unity.

Send feedback about...

Need help? Visit our support page.