Documentation

gwp_urldecode

The gwp_urldecode can be used to decode url encoded values.

:gwp_urldecode

Examples

To apply this Modifier, append it to the Field ID within your Merge Tag as shown below:

{Text:1:gwp_urldecode}

Here’s how some common encoded URL parameters might appear once decoded:

Original ValueDecoded Result
info%40gravitywp.cominfo@gravitywp.com
%22Quotes%22%20and%20spaces“Quotes” and spaces
1%2C2%3B3%3A41,2;3:4

Frequently Asked Questions

What does the gwp_urldecode merge tag modifier do?

This modifier decodes URL-encoded strings into human-readable text. It replaces encoded characters like %20 (space), %40 (@), or %3A (colon) with their actual representations. This is especially useful when working with query strings or hidden fields that receive encoded input.

{Encoded Field:1:gwp_urldecode}

When should I use gwp_urldecode?

Use this modifier when you’re dealing with input that was encoded using URL encoding for example, values passed through query parameters or received from external APIs. It ensures those values are correctly decoded before displaying or using them further.

?field=First%20Name%3DSara%26Last%20Name%3DJones
{Encoded Input:1:gwp_urldecode}

Can I use gwp_urldecode in confirmation messages and email notifications?

Yes. The modifier works inside Gravity Forms confirmation messages, notification emails, redirect URLs, and HTML fields. It decodes the encoded text before outputting it in any of these contexts. However, it does not work inside Gravity Forms calculations.

Original: {Encoded Input:1}
Decoded: {Encoded Input:1:gwp_urldecode}

Does gwp_urldecode support special characters like emojis or Unicode?

Yes, it supports all valid percent-encoded characters, including special symbols, punctuation, and multi-byte Unicode characters like emojis and accented letters. The decoded output preserves these characters properly.

Input: %22Quotes%22%20and%20spaces  
Output: "Quotes" and spaces

Does gwp_urldecode accept any parameters?

No. This modifier does not support any parameters. You simply append :gwp_urldecode to your merge tag, and it will decode the string as expected.

{Your Field Label:field_id:gwp_urldecode}

Last updated: 21-07-2025

Advanced Merge Tagsv1.9.3

To use the functionalities described in this documentation, you'll need to get the GravityWP - Advanced Merge Tags add-on.

Read more