Set URL parameters for a single message
BetaThis feature is new and we're actively working to improve it. UpdatedAdd 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
- Click and choose Switch to Code.
- Click Transformers > URL Parameters.
- Click the toggle to turn on the transformer.
- Add a key and value for each parameter.
- (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>
To disable workspace-defined URL parameters, add `class=
Workspace-defined and message-defined URL parameters are enabled and disabled separately. This gives you more control over your links!