Supporting query params

Advanced Settings in the Project's Console Page provide you with more control over how Dynalinks behave.

When someone opens one of your links, Dynalinks looks up the link by its path, including any query parameters. Two settings let you control which query parameters take part in that lookup:

• Ignored param names: parameters to remove before the lookup.
• Allowed param names: the only parameters to keep for the lookup. All others are removed.

Configure both under Settings → Advanced Settings in your console, by clicking Edit Query Parameters. Only the project Owner and Managers can change them.

Note:
This feature is intended for advanced users and should be configured carefully.

Ignored query parametersCopy Anchor Link

You can set up a list of query parameters that will be ignored when resolving your Dynalinks.

Example:
If you created a link /something/path and an external application appends a query parameter like /something/path?tracking_code=abc when a user clicks it, you can configure tracking_code to be ignored.
Users won't land on a 404 page just because an extra query parameter was added.

How it worksCopy Anchor Link

When you specify query parameters to ignore, Dynalinks will skip them during link lookup.

Example Use Case:
Suppose your app adds tracking parameters like utm_source or utm_tracking to URLs.
You can set the ignored parameters list to:

utm_source,utm_tracking

Now if you create a link /something and a user visits /something?utm_source=google, it still resolves correctly.

Allowed query parametersCopy Anchor Link

The allowed list works the other way around. Instead of naming the parameters to drop, you name the ones that matter, and every other parameter is ignored during link lookup.

This is useful when your links use a few meaningful parameters (for example id or ref) and visitors may arrive with any number of unpredictable extra ones.

Example:
If you created a link /product?id=123 and a user visits /product?id=123&utm_source=google&tracking=abc, with the allowed list set to:

id,ref

Dynalinks keeps only id (and ref, if present), treats the visit as /product?id=123, and finds your link.

Keep in mind:

• Allowed parameters are still compared with your link. With id allowed, /product?id=456 does not resolve to /product?id=123.
• A link without query parameters still matches when only non-allowed parameters are added: with id allowed, /product?tracking=abc resolves to /product.

Using both listsCopy Anchor Link

The allowed list takes precedence. When Allowed param names is set, Ignored param names is not used at all, even if it is also filled in. The ignored list only applies while the allowed list is empty.

Setting Allowed param names to * keeps every query parameter. Because the allowed list is then set, the ignored list is switched off as well, so extra parameters on a visited URL can cause a 404.

Parameters that are always ignoredCopy Anchor Link

Some parameters are added by ad networks and social platforms to almost every click. Dynalinks always removes these during link lookup, whatever your settings:

fbclid, ttclid, gclid, dclid, gad_source

Separately, if a visited URL does not match any link, Dynalinks tries once more with all parameters starting with utm_ removed. That is why /something?utm_source=google finds a link created as /something even when no list is configured.

Sample scenariosCopy Anchor Link

How to configureCopy Anchor Link

• Provide a comma-separated list of query parameter names in either field. Spaces around names are trimmed and duplicates are removed.
• Names must match exactly, including upper and lower case.
• To ignore all query parameters, set Ignored param names to:

*

• To keep all query parameters, set Allowed param names to *.
• Leave a field empty to turn that list off.