Sample Page

A query string is a part of a uniform resource locator (URL) that assigns values to specified parameters. A query string commonly includes fields added to a base URL by a web browser or other client application, for example as part of an HTML document, choosing the appearance of a page, or jumping to positions in multimedia content.

An address bar on Google Chrome showing a URL (Uniform Resource Locator) with the query string title=Query_string&action=edit
An address bar showing a URL (Uniform Resource Locator) with the query string title=Query_string&action=edit

A web server can handle a Hypertext Transfer Protocol (HTTP) request either by reading a file from its file system based on the URL path or by handling the request using logic that is specific to the type of resource. In cases where special logic is invoked, the query string will be available to that logic for use in its processing, along with the path component of the URL.

Structure

A typical URL containing a query string is as follows:

URL encoding

Some characters cannot be part of a URL (for example, the space) and some other characters have a special meaning in a URL: for example, the character # can be used to further specify a subsection (or fragment) of a document. In HTML forms, the character = is used to separate a name from a value. The URI generic syntax uses URL encoding to deal with this problem, while HTML forms make some additional substitutions rather than applying percent encoding for all such characters. SPACE is encoded as ‘+‘ or “%20“.[11]

HTML 5 specifies the following transformation for submitting HTML forms with the “GET” method to a web server. The following is a brief summary of the algorithm:

  • Characters that cannot be converted to the correct charset are replaced with HTML numeric character references[12]
  • SPACE is encoded as ‘+‘ or ‘%20
  • Letters (AZ and az), numbers (09) and the characters ‘~‘,’-‘,’.‘ and ‘_‘ are left as-is
  • + is encoded by %2B
  • All other characters are encoded as a %HH hexadecimal representation with any non-ASCII characters first encoded as UTF-8 (or other specified encoding)

The octet corresponding to the tilde (“~“) is permitted in query strings by RFC3986 but required to be percent-encoded in HTML forms to “%7E“.

The encoding of SPACE as ‘+‘ and the selection of “as-is” characters distinguishes this encoding from RFC 3986.

Example

If a form is embedded in an HTML page as follows:

<form action="/cgi-bin/test.cgi" method="get"> <input type="text" name="first" /> <input type="text" name="second" /> <input type="submit" /> </form>

and the user inserts the strings “this is a field” and “was it clear (already)?” in the two text fields and presses the submit button, the program test.cgi (the program specified by the action attribute of the form element in the above example) will receive the following query string: first=this+is+a+field&second=was+it+clear+%28already%29%3F.

If the form is processed on the server by a CGI script, the script may typically receive the query string as an environment variable named QUERY_STRING.

Tracking

A program receiving a query string can ignore part or all of it. If the requested URL corresponds to a file and not to a program, the whole query string is ignored. However, regardless of whether the query string is used or not, the whole URL including it is stored in the server log files.

These facts allow query strings to be used to track users in a manner similar to that provided by HTTP cookies. For this to work, every time the user downloads a page, a unique identifier must be chosen and added as a query string to the URLs of all links the page contains. As soon as the user follows one of these links, the corresponding URL is requested to the server. This way, the download of this page is linked with the previous one.

For example, when a web page containing the following is requested:

<a href="foo.html">see my page!</a> <a href="bar.html">mine is better</a>

a unique string, such as e0a72cb2a2c7 is chosen, and the page is modified as follows:

<a href="foo.html?e0a72cb2a2c7">see my page!</a> <a href="bar.html?e0a72cb2a2c7">mine is better</a>

The addition of the query string does not change the way the page is shown to the user. When the user follows, for example, the first link, the browser requests the page foo.html?e0a72cb2a2c7 to the server, which ignores what follows ? and sends the page foo.html as expected, adding the query string to its links as well.

This way, any subsequent page request from this user will carry the same query string e0a72cb2a2c7, making it possible to establish that all these pages have been viewed by the same user. Query strings are often used in association with web beacons.

The main differences between query strings used for tracking and HTTP cookies are that:

  1. Query strings form part of the URL, and are therefore included if the user saves or sends the URL to another user; cookies can be maintained across browsing sessions, but are not saved or sent with the URL.
  2. If the user arrives at the same web server by two (or more) independent paths, it will be assigned two different query strings, while the stored cookies are the same.
  3. The user can disable cookies, in which case using cookies for tracking does not work. However, using query strings for tracking should work in all situations.
  4. Different query strings passed by different visits to the page will mean that the pages are never served from the browser (or proxy, if present) cache thereby increasing the load on the web server and slowing down the user experience.

Compatibility issues

According to the HTTP specification:

Various ad hoc limitations on request-line length are found in practice. It is RECOMMENDED that all HTTP senders and recipients support, at a minimum, request-line lengths of 8000 octets.[13]

If the URL is too long, the web server fails with the 414 Request-URI Too Long HTTP status code.

The common workaround for these problems is to use POST instead of GET and store the parameters in the request body. The length limits on request bodies are typically much higher than those on URL length. For example, the limit on POST size, by default, is 2 MB on IIS 4.0 and 128 KB on IIS 5.0. The limit is configurable on Apache2 using the LimitRequestBody directive, which specifies the number of bytes from 0 (meaning unlimited) to 2147483647 (2 GB) that are allowed in a request body.[14]

See also

References

  1. T. Berners-Lee; R. Fielding; L. Masinter (January 2005). “RFC 3986”. “Syntax Components” (section 3).
  2. T. Berners-Lee; R. Fielding; L. Masinter (January 2005). “RFC 3986”. “Query” (section 3.4).
  3. 1 2 Forms in HTML documents. W3.org. Retrieved on 2013-09-08.
  4. “ServletRequest (Java EE 6 )”. docs.oracle.com. 2011-02-10. Retrieved 2013-09-08.
  5. “uri – Authoritative position of duplicate HTTP GET query keys”. Stack Overflow. 2013-06-09. Retrieved 2013-09-08.
  6. Performance, Implementation, and Design Notes. W3.org. Retrieved on 2013-09-08.
  7. “4.10 Forms — HTML5”.
  8. , HTML5.2, W3C recommendation, 14 December 2017
  9. <isindex>. HTML (HyperText Markup Language). Archived from the original on 2017-10-19. Retrieved 2015-11-21.
  10. “HTML/Elements/isindex”. W3C Wiki. Archived from the original on 2021-06-22. Retrieved 2020-03-20.
  11. “HTML URL Encoding Reference”. W3Schools. Retrieved May 1, 2013.
  12. The application/x-www-form-urlencoded encoding algorithm, HTML5.2, W3C recommendation, 14 December 2017
  13. HTTP/1.1 Message Syntax and Routing. ietf.org. Retrieved on 2014-07-31.
  14. core – Apache HTTP Server. Httpd.apache.org. Retrieved on 2013-09-08.