Help

Add Query Parameters to a URL

Type an address and a few key and value pairs and the query string is built for you: the ? and & are placed, spaces and special characters are encoded, and the link updates on every keystroke. It works on a full URL or on a path such as /api/search, and you choose whether a space becomes %20 or +.


How to build a URL with parameters

  1. Enter the address in Base URL. A full URL, a path or any other text is accepted and is never rejected.
  2. In Parameters, type a key and a value in the first row, for example utm_source and newsletter. Press Add parameter for each further pair. The remove button at the end of a row deletes it.
  3. Read the link in Constructed URL. It changes as you type, and rows appear in the URL in the same order as in the list.
  4. Leave Encoding mode on its default, or switch it (see below), then press Copy URL. The button reads "Copied" for a moment.
Base URL and Parameters
  • Base URL: https://example.com/search#results
  • q = red shoes & socks
  • utm_source = newsletter
  • lang = café
Constructed URL
  • Standard URI: https://example.com/search?q=red%20shoes%20%26%20socks&utm_source=newsletter&lang=caf%C3%A9#results
  • Form encoding: https://example.com/search?q=red+shoes+%26+socks&utm_source=newsletter&lang=caf%C3%A9#results

The #results fragment stays at the end, after the query, however many rows you add.

Edit a URL that already has parameters

Paste a link such as https://example.com/shop?color=dark+blue&size=M#reviews into Base URL. The base becomes https://example.com/shop#reviews and two rows appear in Parameters: color = dark blue and size = M. Change a value, delete a row or add one, and the link is rebuilt. If you type the base by hand, the query is moved into the rows when you leave the field or press Enter, so a half-typed ?ke is not cut under your cursor.

Existing %20 and + are decoded into the boxes and encoded again on the way out. A + in a pasted query is read as a space, because that is what it means in a query string. A real plus sign is written %2B.

Space as %20 or +: which encoding mode?

Both modes percent-encode everything unsafe. They differ in how a space is written and in two rarely used characters.

CharacterStandard URI (space as %20)Form encoding (space as +)
Space%20+
*%2A* (left as is)
~~ (left as is)%7E
+%2B%2B
é and other non-ASCII%C3%A9 (UTF-8)%C3%A9 (UTF-8)

Standard URI follows RFC 3986: only letters, digits and - . _ ~ are left as they are, and ! * ' ( ) / & = # % are all encoded. It is right for almost every link, including links in email and social posts. Form encoding is the application/x-www-form-urlencoded format that an HTML form sends. Pick it only for an endpoint that expects + for spaces, such as a legacy search form or an API that was written against form posts.

Keys, values and empty rows

What it does not do

This is a plain key and value builder. It does not shorten links or check that an address opens, and it adds parameters to one URL at a time. There are no UTM presets, drop-downs or campaign fields: utm_source, utm_medium and utm_campaign are ordinary keys that you type, which also means you can use any tracking scheme, API parameter or filter name. A Base URL with no https:// in front, such as example.com, is treated as the text you typed and no scheme is added.

After you have the link

To put the link on a poster or a flyer, turn it into a code with the Static QR Code Generator. To pull the links out of a page of text or HTML first, use URL Extractor, and to check an address against a pattern, try the Regex Tester.


Frequently asked questions

How do I add query parameters to a URL?

Type or paste the address into Base URL, then fill a key and a value in the Parameters list. The Constructed URL box shows the link with ? or & placed for you and every special character encoded. Press Copy URL to take it.

How do I add multiple parameters to a URL?

Press Add parameter for each extra pair. The rows are joined with & in the order they appear in the list, so the first row comes first in the URL. Use the remove button at the end of a row to take a pair out.

Should a space in a URL be %20 or +?

%20 is safe almost everywhere, so Standard URI (space as %20) is the default. A + means a space only inside a query string, and only for servers that read it as form data. Choose Form encoding (space as +) when an endpoint or an HTML form expects it.

How do I add UTM parameters to a URL?

Put your page address in Base URL and add one row per tag: utm_source with newsletter, utm_medium with email, utm_campaign with spring_sale. The tool treats them like any other key, so it has no preset fields or drop-downs for campaigns, and it does not check your naming.

What does a URL query string look like?

It is the part after the ?, made of key=value pairs joined by &, for example https://example.com/shop?color=blue&size=M. Anything after a # is the fragment and is not part of the query string.

How do I encode special characters in a URL parameter?

Type the key and value as plain text and the tool encodes them. In Standard URI mode only letters, digits and - . _ ~ are left as they are; a space becomes %20, & becomes %26, = becomes %3D, # becomes %23, a literal + becomes %2B and a character like é becomes %C3%A9.

Can I edit a URL that already has parameters?

Yes. Paste the full link into Base URL. Its parameters move into the Parameters list, decoded so you can read and change them, and the base keeps the path and any #fragment. Text you type is split when you leave the field or press Enter.

What happens to the #fragment and to empty rows?

The #fragment always stays last. A row with a key and no value gives key=, a row with nothing in it is ignored, and a row with a value but no key is left out of the URL and shows a warning until you add the key.

Can I use the same key twice?

Yes. Duplicate keys are kept in the order of the rows, so page=2 followed by page=3 gives ?page=2&page=3. That is how many servers read a list of values for one name.

Does it shorten the link or check that it works?

No. It only builds the text of the URL. It does not shorten links, test whether the address opens, or add parameters to several URLs at once.

Is my URL sent anywhere?

No. The link is built in your browser and nothing is sent or saved, so a URL with a token or an internal host name stays on your device.


Recommended

Helps keep the tools free. ✨

Images are for illustration only. As an Amazon Associate I earn from qualifying purchases.