---
title: "Breaking: #98488 - Typolink option \"addQueryString\" only includes resolved query arguments"
manual: "TYPO3 Core Changelog"
version: "main"
permalink: "https://docs.typo3.org/permalink/changelog:breaking-98488-1664578695"
source: "Changelog/12.0/Breaking-98488-TypolinkOptionAddQueryStringOnlyIncludesResolvedQueryArguments.rst"
modified: "2026-09-15T10:46:36+00:00"
---

# Breaking: #98488 - Typolink option "addQueryString" only includes resolved query arguments

See [forge#98488](https://forge.typo3.org/issues/98488)

## Description

The Typolink option `typolink.addQueryString` previously set all given
GET parameters to a generated URL that were handed in to the request.

This option is also used under the hood for the  Fluid ViewHelpers
`<f:link.typolink>`, `<f:uri.typolink>`, `<f:link.page>`,
`<f:uri.page>`, `<f:link.action>`, `<f:link.action>` and
`<f:form>`.

With TYPO3 v9 and routing, this option now only adds the query arguments that
have been resolved during the routing process. This way, additional query arguments
are never added by default.

## Impact

Setting `typolink.addQueryString = 1` now adds only arguments resolved
by Route Enhancers, any other query arguments are rejected.

As a consequence, arbitrary query arguments are not reflected in the
canonical link reference anymore. Declaring corresponding route definitions
is required to have those values reflected again.

## Affected installations

TYPO3 installations relying on `typolink.addQueryString`.

## Migration

It is recommended to keep the setting as is, as TYPO3 can identify valid query
arguments via Routing.

However, to ensure the previous behaviour, the option
`typolink.addQueryString` can be set to `untrusted` to add all given.

The same value is also possible for the Fluid ViewHelpers
`<f:link.typolink>`, `<f:uri.typolink>`, `<f:link.page>`,
`<f:uri.page>`, `<f:link.action>`, `<f:link.action>` and
`<f:form>`.