20

Set URL parameters for a single message

Add URL parameters through the code editor in Design Studio to help you track and analyze how your customers interact with your messages.

You can define URL parameters in two ways:

• Across all messages in Workspace Settings
• For a single email made in Design Studio

This article shows you how to add URL parameters to a single message made in Design Studio.

If you set URL parameters in workspace settings and in a single message, we append all parameters to your links. One does not override the other, so make sure you don’t duplicate URL parameters across these locations.

Add URL parameters to a Design Studio message

1. Click and choose Switch to Code.
2. Click Transformers > URL Parameters.
3. Click the toggle to turn on the transformer.
4. Add a key and value for each parameter.
5. (Optional) Click Encode to turn off encoding for a parameter.

Click to remove a parameter.

Encode URL parameters

By default, we encode each URL parameter. Encoding replaces special characters so they can safely be sent inside of links.

If a URL parameter includes hello world, encoding replaces the space with %20, so the output becomes hello%20world.

You might disable encoding if you escaped the parameter value before entering it into the transformer.

Ignore URL parameters defined in a message

If you want a link to not contain message-defined URL parameters, add data-ignore-params. For instance, perhaps you link to your company’s X account and you don’t want to send the parameters to X.

<a href="https://x.com/CustomerIO" data-ignore-params>Icon</a>

The output for this would be:

<a href="https://x.com/CustomerIO">Icon</a>