Query String Parameter

How does it work?

This criterion lets you match based on the absence, presence, or the values of query string parameters in your URLs.

Operators

You can select the following logical conditions:

Value The Rule is True When...
is one ofany of the query string values you specified in the text field is present in the requested URL.
is not one ofany of the query string values you specified in the text field is not present in the requested URL.
existsany of the parameter names you specified in the text field is present in the requested URL. It checks for the presence, not the value of the parameter.
does not existany of the parameter names you specified in the text field is not present in the requested URL. It checks for the absence, not the value of the parameter.
is less thanthe numeric query string value is less than the lower bound you provided.
is more thanthe numeric query string value is greater than the upper bound you provided.
is in rangethe numeric query string value is between the lower and upper bounds you provided.

Fields

Query strings use the ?param=valueformat.

In the name field, enter the parameter of the query string you want to use for the match, for example, title in ?topic=HTTPS.

Optionally, you can specify the value of the query string, for example, HTTPSin ?topic=HTTPS.

For a large number of values, you can paste the addresses and separate them with a space, comma, or carriage return. If you omit the value, the match applies to any request that contains the parameter.

Wildcards

Wildcard Description Example
* matches zero or more charactersThe rule includes a match where the query string value is 123*. Some possible valid results are 123 and123456.
? matches a single characterThe rule includes a match where the query string value is 123?. Some possible valid results are 123 and 1234.

Additional Options

  • Wildcards in name: When enabled, allows * and ? wildcard matches in the parameter name field.

  • Case-sensitive name: If you select this option, the parameter name in the incoming request has to match the case of the entry.

  • Wildcards in value: When enabled, allows * and ? wildcard matches in the value field.

  • Case-sensitive value: If you select this option, the value in the incoming request has to match the case of the entry.

  • Escaped value: When enabled, matches when the value is URL-escaped.