[Dynamic Links] How to get query parameters from dynamic link?

[achubutkin]

Describe the bug
The documentation does not describe how to get a dynamic link URL or its query parameters. Attention! Dynamic link query parameters, not included deeplink!

[karapetyan]

Same here. How to get query parameters from firebase dynamic link inside app?

https://testapp.page.link/ios?param=paramValue
How to get "paramValue"

[SnowStar0423]

The created Deep Link does not give the query Parameters when user enters it in the Chrome browser.
In other words, Chrome browser removes the generated query parameters when my friend clicks the link.
What's why?
Have you received the correct parameters values from the created Deep Links again?

[mahmoudelgawad]

Same here,

 final data = await FirebaseDynamicLinks.instance.getInitialLink();
 final Uri deepLink = data?.link;

when deepLink .hasQuery is always false

[SnowStar0423]

The created Deep Link does not give the query Parameters when user enters it in the Chrome browser.
In other words, Chrome browser removes the generated query parameters when my friend clicks the link.
What's why?
Have you received the correct parameters values from the created Deep Links again?

[mahmoudelgawad]

I fixed by the following document

https://firebase.google.com/docs/dynamic-links/create-manually

[SnowStar0423]

The created Deep Link does not give the query Parameters when user enters it in the Chrome browser.
In other words, Chrome browser removes the generated query parameters when my friend clicks the link.
What's why?
Have you received the correct parameters values from the created Deep Links again?

[KlausJokisuo]

Any news on this?

[KingIdee]

You can do this. Where your query param is code :

final Uri deepLink = dynamicLink?.link;
deepLink.queryParameters['code']

[luis-cruzt]

The approach of @KingIdee is the correct one.

Example, following @karapetyan question:

Future handleDynamicLinks() async {

    // Get initial dynamic link if the app is started using the link
    final PendingDynamicLinkData data = await FirebaseDynamicLinks.instance.getInitialLink();
    
    handleDeepLink(data);

    // Into foreground from dynamic link logic
    FirebaseDynamicLinks.instance.onLink(
      onSuccess: (PendingDynamicLinkData dynamicLinkData) async {
        handleDeepLink(dynamicLinkData);
      },
      onError: (OnLinkErrorException e){
        print('Dynamic Link Failed: $e');
      }
   );
}

void handleDeepLink(PendingDynamicLinkData data) {

         final Uri deepLink = data?.link;
         var paramValue = deepLink.queryParameters['paramValue'];

         if (deepLink != null) {
           print('deepLink detected: $deepLink');
           print('deepLink data: $paramValue');
              
         }         
 }

[SnowStar0423]

This is how to get the value of the query parameters when they are in the regenerated deep links.
In fact, when we create a new dynamic link programmatically, if we type the created deep links or click it on other app, we don't receive the query parameters from the deep links.
Did you receive the value of the query parameters in your project really?

[hackerunet]

is it possible to pass dynamic query parameters instead of plain parameters? normally an application creates a token from backend and send a link to the email with a token, how can I pass that token to the dynamic link? right now I can get a query parameter if is defined in the console with ?parameter but no matter if my link has a value, in the console as the parameter has no value at all I get null, if I add in the console ?parameter=xxx I get xxx but, that's not the idea. so, anyone can please help me out to understand this, since the documentation has no enough information regarding this.

[astronaute77]

I face the same issue, the query parameters are lost during URL conversion.
I opened another ticket highlighting the issue:
#3125

[kostacasa]

It's really bizarre that the e-mail templating system from Firebase auth is essentially incompatible with dynamic links.

In the Firebase docs here:
https://firebase.google.com/docs/dynamic-links/create-manually

It says:

Specify a URL that your app can handle, typically the app's content or payload, which initiates 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 either HTTP or HTTPS, and cannot be another Dynamic Link.

Bolded section being key.

However, Firebase e-mail templating attaches the mode and code query parameterrs mode=<action>&oobCode=<code> without URL encoding anything. That means it's impossible to define the password reset link as a dynamic link by using something like this:

https://your_subdomain.page.link/?link=https%3A%2F%2Fyour.domain%2F__%2Fauth%2Faction%2F%3F

Because firebase will tack on the query parameters without URLEncoding them, resulting in a link that looks like:

https://your_subdomain.page.link/?link=https%3A%2F%2Fyour.domain%2F__%2Fauth%2Faction%2F%3F&mode=resetPassword&oobCode=9icrng4K_sp_MSbYg2onUghNyYDROiX2EQLTaRdz4bofAAF0DeRWzw&lang=en

Notice the ampersand & characters. By inserting a non-urlencoded ampersand at the end, those parameters simply "escape" from the link= query parameter and become parameters of the page.link instead.

Since the dynamic link system knows nothing about "oobCode" and other parameters, it will simply drop them, and the final link will miss the necessary context to complete the operation.

[brad353]

Any updates on this? I'm also facing the same issue.

[varunkumarmedam]

You can use https://pub.dev/packages/uni_links. This will help in getting the raw URL having query params also. So you don't need to use the flutter dynamic links package if you don't need the retrieving link data.

I know this is not the solution we really need, but it works at least for now

[astronaute77]

You can use https://pub.dev/packages/uni_links. This will helps in getting the raw url having query params also. So you dont need to use flutter dynamic links package if you dont need the retrieving link data

Uni links is totally different use-case unrelated to this issue. This is about firebase dynamic links losing initial query parameters.

[varunkumarmedam]

You can use https://pub.dev/packages/uni_links. This will helps in getting the raw url having query params also. So you dont need to use flutter dynamic links package if you dont need the retrieving link data

Uni links is totally different use-case unrelated to this issue. This is about firebase dynamic links losing initial query parameters.

Of course, this is not related to Firebase Dynamic Links, I just explained how to make the things work. Uni_links helped my project to achieve what I need that which cant be done with Dynamic links

[LwinMaungMaungDev]

That's right, using uni_links can fetch the raw url including params, for example, "https://deeplinkname.page.link/?ABCD1234", where ABCD1234 is the parameter. Parameters should be a-z and numbers (cannot include special chars *, >, and &).

[astronaute77]

You can use https://pub.dev/packages/uni_links. This will helps in getting the raw url having query params also. So you dont need to use flutter dynamic links package if you dont need the retrieving link data

Uni links is totally different use-case unrelated to this issue. This is about firebase dynamic links losing initial query parameters.

Of course, this is not related to Firebase Dynamic Links, I just explained how to make the things work. Uni_links helped my project to achieve what I need that which cant be done with Dynamic links

I’m happy it works for you an uni_links is great. It just is not a workaround for this issue you are commenting on.

[marcscherer]

Any updates on this?

[tudor07]

The problem is inside Firebase REST API, but can be fixed from the plugin as well.
The plugin does this REST call internally:

curl --request POST \
  --url 'https://firebasedynamiclinks.googleapis.com/v1/reopenAttribution?key={firebase_key}' \
  --header 'content-type: application/json' \
  --header 'x-ios-bundle-identifier: {bundle_identifier}' \
  --data '{
	"bundle_id": "{bundle_identifier}",
	"sdk_version": "4.0.8",
	"requestedLink": "https://subdomain.domain.com/path?param=123456"
}'

This call returns:

{
  "deepLink": "https://subdomain.domain.com/path",
  "resolvedLink": "https://subdomain.domain.com/?link=https://subdomain.domain.com/path&apn={bundle_identifier}&isi=1493910790&ibi={bundle_identifier}&st={st}&sd={sd}?&si={si}"
}

Then the URL sent back to Flutter is the URL got from the response from the deepLink field.
Notice how in the request we sent https://subdomain.domain.com/path?param=123456 and in the response we got back https://subdomain.domain.com/path. So Firebase backend removes ?param=123456. What can the Flutter plugin do is ignore the deepLink from response and send back to Dart the original requestedLink which also has the params.

This is what I noticed for iOS.
On Android the URL does not have the query parameters from the start, so I don't think we can make it work just from the Flutter plugin.

[Vasault]

Has this been fixed yet? branch.io actually supports params without going for the long url, i had to jump from firebase to branch, and now branch is having issues so i'm trying to go back to firebase once more

[bmennear]

Is there any plans for a solution to this? With the main issue being closed it appears not. This is basic functionality that should exist. Without this short links are completely unusable in our use case (web users on mobile or desktop devices). We need to append something that uniquely identifies a user like an id. https://short.link/QQQQ?id=1234 should not dump the query params on redirect.

I tried using anchor links instead, which do get passed (https://short.link/QQQQ#test or even https://short.link/QQQQ/#/test) however mobile browsers drop the anchor link / fragment. Works fine on web but this was a hack to try and restore functionality that should exist out of the box.

[dtheodor79]

Sorry, is there any update on this issue?

Unless I miss something, in our case where we use dynamic links for email password reset, the oobCode, mode and apiKey params are removed!

[ndesamuelmbah]

Still facing this issue. Has anyone found any solution yet?

[sarinupreti2021]

having the same issue.

this is my dynamic links :

https://example.page.link/resetpassword?token=FDOJ@#$#$#$#$

when I try to parse this in the app it shows me :
https://example.page.link/resetpassword and queryParameters is always false.

[federicogomez1-gj]

Hello @sarinupreti2021. Has found any solution yet?

[chunlee-thong]

You can use another package to handle the link like https://pub.dev/packages/uni_links or https://pub.dev/packages/app_links because firebase dynamic is just a place to register a domain and link for your app. in the end, it's just an app link or universal link. I've been tested and it works.

[noah-swf]

I can highly recommend uni_links for this problem👍Quite easy to use and does what it's supposed to do.

[ekox]

Same problem, and finally i got this conclusion :

• uni_links/ app_links not working on android development (localhost) because custom scheme deep link like "app://myapp?token=xyz...." will be rejected from chrome browser
• app link (https only) not working on development
• stay on firebase flutter with some change on auth flow

there are 2 options with firebase dynamic links :

1. Using REST API Dynamic Link Firebase (POST) to send custom query param URL inside our server side (backend). After sending the request, we would get a dynamic link from the server, then forward or redirect to that link so our flutter app can parse all query param we sent to API before.
   pros : simple
   cons : maybe not to secure because we sent our token to firebase

2. Create unique ID from flutter (device id + timestamp or whatever...), generate link (short/long and dont forget to save inside sharedpreference or whatever) , send that unique ID + generate link to our auth flow (Auth Web App). Our backend have to save that unique ID and then link from flutter. After auth flow have finished, redirect to that generate link. Our flutter will be triggered to check that dynamic link, and GET HTTP API to our backend (with unique ID before) to GET our token.
   pros : maybe more secure than first option
   cons : change our auth flow in the end

Good luck my friend....(sorry my english is very bad...)

[LeonardoRosaa]

I suppose that problem occurs by the way the dynamic link is built.

The Firebase Dynamic Link requires Dynamic Link parameters to configure your query parameters in your dynamic link. I will highlight the Dynamic Link format that does work for me below:

https://your.subdomain.page.link/?link=your_deep_link&apn=android.package.name&ibi=ios.package.name&ius=your.custom.url.scheme

The link above should work well on the Android platform. However, for the IOS platform there’re two more tricks:

• Query parameters in the deep link should be encodable;
• It’s required the ius optional Dynamic Link parameter. You can click here to look at how to configure your custom URL scheme and use ius parameter.

[JosteveGit]

There is a getDynamicLink method that expects a Uri to be passed. It returns a PendingDynamicLinkData and the queryParameters can be gotten from the response.

See this:

      final x = await FirebaseDynamicLinks.instance.getDynamicLink(
        Uri.parse(link),
      );
      final deepLink = x?.link;
      if (deepLink == null) {
        return;
      }
      final queryParameters = deepLink.queryParameters;
      final longLink = deepLink.toString();

[nasir-azeemi]

Hey guys, I am having this issue too.
I have two dynamic links.
I tried to create both short and long links however, the full link is not returned by messging.getInitialLink()

Here's my code:

Here's my console logs:

[SMKH-PRO]

So it was never solved?

[sebastijandumancic]

It seems like this still hasn't been solved. I haven't managed to pass a custom property to a deeplink to be resolved in-app, such as activation code / coupon / etc.

[sebastijandumancic]

Ok, I figured it out, and it should be a final solution to this.

You definitely need to follow manually creating a dynamic link, but it doesn't tell you that you NEED to implement some tags in order to open up the correct app since it's going around what's in the Firebase Dynamic Link dashboard.

So, based on this: https://firebase.google.com/docs/dynamic-links/create-manually, I've constructed a following link:

https://example.page.link/?link=https://www.example.com/id?id=12345&apn=com.example.app&amv=3&ibi=com.example.app&isi=1234567&ius=exampleapp

Where you must specify correct bundle id to open up the app, I'm not sure about the version (amv) or isi, but ibi and ius is required. After that when you resolve the link in the navigator, I get:

{"minimumAppVersion": 3, "url": "https://www.setfords.co.uk/reference-id?id=12345", "utmParameters": {}}

From where it's easy to resolve the id query param in the URL prop. Note that custom part is passed to the link parameter in the link, not in the initial path, since that's hardcoded in the firebase URL. You probably do need one base dynamic link defined in the dashboard so you get proper page.link web generated.

Let me know if this works, it's been a journey.

[szaboagoston]

Ok, I figured it out, and it should be a final solution to this.

You definitely need to follow manually creating a dynamic link, but it doesn't tell you that you NEED to implement some tags in order to open up the correct app since it's going around what's in the Firebase Dynamic Link dashboard.

So, based on this: https://firebase.google.com/docs/dynamic-links/create-manually, I've constructed a following link:

https://example.page.link/?link=https://www.example.com/id?id=12345&apn=com.example.app&amv=3&ibi=com.example.app&isi=1234567&ius=exampleapp

Where you must specify correct bundle id to open up the app, I'm not sure about the version (amv) or isi, but ibi and ius is required. After that when you resolve the link in the navigator, I get:

{"minimumAppVersion": 3, "url": "https://www.setfords.co.uk/reference-id?id=12345", "utmParameters": {}}

From where it's easy to resolve the id query param in the URL prop. Note that custom part is passed to the link parameter in the link, not in the initial path, since that's hardcoded in the firebase URL. You probably do need one base dynamic link defined in the dashboard so you get proper page.link web generated.

Let me know if this works, it's been a journey.

For me it did not work either.

[mt-akar]

This worked for me like a charm. Instead of adding custom query parameters to the entire link, add them to the link passed to the link query parameter.

In my case, no other parameter, such as ibi and isi was required.

[victorhuberta]

Hi everyone, I am following the Firebase instructions for Sign-in with Email Link (firebase_auth: ^4.6.3, firebase_dynamic_links: ^5.3.4) and the URL encoding issue described by @kostacasa still remains. It looks similar to this, using the Firebase emulator and manually created dynamic link -- passed to url parameter of ActionCodeSettings:

http://127.0.0.1:9099/emulator/action?mode=signIn&lang=en&oobCode=-_FXnuwyj0--9hiJLSezy3hW68tGiba2i7hbqu7C5bLIq_-gh8jRvx&apiKey=fake-api-key&continueUrl=https%3A%2F%2Fmy.page.link%2F%3Fapn%3Dcom.my.client%26efr%3D1%26link%3Dhttps%3A%2F%2Fexample.com

which resolves to...

https://my.page.link/?apn=com.my.client&efr=1&link=https%3A%2F%2Fexample.com&mode=signIn&lang=en&oobCode=-_FXnuwyj0--9hiJLSezy3hW68tGiba2i7hbqu7C5bLIq_-gh8jRvx&apiKey=fake-api-key

The part starting from &mode=signIn becomes parameters of my.page.link and not of https://example.com, which means my app received the deep link only as 'https://example.com' and so Firebase.instance.isSignInWithEmailLink will always fail.

[chanonsut]

Hey guys, if you guys are still stuck. I have this solution. it so basically but work.

1. You click a "Link detail" in firebase dynamic link. then you copy "Long Dynamic Link"
2. You will get link like this "https://app.page.link/?link=http://example.page.app&apn=com.example.app&isi=1111111111&ibi=com.example.app"
3. focus on parameter "link=http://example.page.app" in this you add variable in get method like "http://example.page.app?data=123". => example with full link : "https://app.page.link/?link=http://example.page.app?data=123&apn=com.example.app&isi=1111111111&ibi=com.example.app"
4. if you will use in flutter project try to use firebase_dynamic_links

example

  void fetchLinkData() async {
    try{
      var link = await FirebaseDynamicLinks.instance.getInitialLink();
      handleLinkData(link!);

    } catch (e) {
      print(e.toString());
    }
  }

  void handleLinkData(PendingDynamicLinkData data) async {
    final Uri? uri = data.link;
    print(uri) // => http://example.page.app?data=123
   }

I holp it can help you guys.

[jaymin2609]

Try Below the mentioned solution. It's worked for me

FirebaseDynamicLinks dynamicLinks = FirebaseDynamicLinks.instance;

      PendingDynamicLinkData? pendingDynamicLinkData =
          await dynamicLinks.getDynamicLink(Uri.parse("<YOUR_DYNAMIC_LNK>"));
      if (pendingDynamicLinkData != null &&
          pendingDynamicLinkData.link.hasQuery) {
        final queryParametersAll =
            pendingDynamicLinkData.link.queryParametersAll;
       
      }