{"id":31536,"date":"2018-04-21T15:47:48","date_gmt":"2018-04-21T15:47:48","guid":{"rendered":"https:\/\/ampscript.guide\/urlencode\/"},"modified":"2021-04-06T00:58:42","modified_gmt":"2021-04-06T00:58:42","slug":"urlencode","status":"publish","type":"post","link":"https:\/\/ampscript.guide\/urlencode\/","title":{"rendered":"UrlEncode"},"content":{"rendered":"

UrlEncode<\/h2>\n

This function returns a string in which all non-alphanumeric characters except -<\/code>, _<\/code> and .<\/code> have been replaced with a percent sign (%<\/code>) followed by the equivalent hex value. Spaces are encoded as plus (+<\/code>) signs. The string is encoded in the same way that the posted data from an HTML form is encoded or an application\/x-www-form-urlencoded<\/code> media type. This function is useful when including values as URL parameters in hyperlinks to ensure the string encoding is preserved.<\/p>\n

Arguments<\/h3>\n

URLEncode(1,2,3)<\/code><\/p>\n\n\n\n\n\n\n\n
Ordinal<\/th>\nType<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
1<\/td>\nString<\/td>\nTrue<\/td>\nString containing the URL or value<\/td>\n<\/tr>\n
2<\/td>\nInteger<\/td>\nFalse<\/td>\nDefines whether to convert all non-alphanumeric characters as URL parameters (0<\/code>) or only as space characters (1<\/code>). The default value is 0<\/code>.<\/td>\n<\/tr>\n
3<\/td>\nInteger<\/td>\nFalse<\/td>\nDefines whether to only encode characters in a string prefixed by a URL (0<\/code>) or all characters (1<\/code>). The default value is 0<\/code>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n

NOTE: Only URL parameters where the URL is suffixed by a ?<\/code> character will be encoded.<\/p>\n<\/blockquote>\n

Supported non-alphanumeric characters and their respective encoded values are provided below.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Character<\/th>\nEncoded Character<\/th>\nCharacter<\/th>\nEncoded Character<\/th>\n<\/tr>\n<\/thead>\n
newline<\/td>\n%0a<\/code><\/td>\nspace<\/td>\n%20<\/code> or +<\/code> (see note)<\/td>\n<\/tr>\n
~<\/td>\n%7e<\/code><\/td>\n#<\/td>\n%23<\/code><\/td>\n<\/tr>\n
"<\/td>\n%22<\/code><\/td>\n&<\/td>\n%26<\/code><\/td>\n<\/tr>\n
%<\/td>\n%25<\/code><\/td>\n‘<\/td>\n%27<\/code><\/td>\n<\/tr>\n
,<\/td>\n%2c<\/code><\/td>\n+<\/td>\n%2b<\/code><\/td>\n<\/tr>\n
<<\/td>\n%3c<\/code><\/td>\n\/<\/td>\n%2f<\/code><\/td>\n<\/tr>\n
><\/td>\n%3e<\/code><\/td>\n:<\/td>\n%3a<\/code><\/td>\n<\/tr>\n
&bsol;<\/td>\n%5c<\/code><\/td>\n;<\/td>\n%3b<\/code><\/td>\n<\/tr>\n
^<\/td>\n%5e<\/code><\/td>\n=<\/td>\n%3d<\/code><\/td>\n<\/tr>\n
_<\/td>\n%5f<\/code><\/td>\n?<\/td>\n%3f<\/code><\/td>\n<\/tr>\n
&grave;<\/td>\n%60<\/code><\/td>\n@<\/td>\n%40<\/code><\/td>\n<\/tr>\n
{<\/td>\n%7b<\/code><\/td>\n[<\/td>\n%5b<\/code><\/td>\n<\/tr>\n
&verbar;<\/td>\n%7c<\/code><\/td>\n]<\/td>\n%5d<\/code><\/td>\n<\/tr>\n
}<\/td>\n%7d<\/code><\/td>\n$<\/td>\n%24<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n

NOTE: When parameter 2 is set to an argument value of 1<\/code>, the space character will be converted to +<\/code>. When the parameter is set to an argument value of 1<\/code>, the space character will be converted to %20<\/code> and all other characters will not be converted.<\/p>\n<\/blockquote>\n

Example 1<\/h3>\n
%%[\n\nvar @offer\nset @offer = \"summer offer\"\n\n]%%\n\n%%=URLEncode(@offer)=%%<\/code><\/pre>\n
Output<\/h4>\n
No conversion takes place, as there is no URL included.<\/p>\n
summer offer<\/code><\/pre>\n
Example 2<\/h3>\n
\n\n\n\t\n\t
\n\n\t\t\n\t\t