URL parameters automatically append tracking values to links in mailing content. Use them for shared reporting fields like UTM parameters, campaign identifiers, source labels, or other link metadata that should travel with email clicks.

Parameter values can be static or dynamic:

• Static values are entered as plain text, such as utm_medium=email or utm_source=newsletter.
• Dynamic values use macros that are replaced when the mailing content is prepared, such as subscriber_id={$subscriber.id} or email={$email}.

The URL Parameters form includes a macro selector next to each value field. Use it to choose from available system macros and subscriber variables, or type a static value directly.

OptiPub supports URL parameters at multiple levels:

How Parameters Are Applied

When mailing content is prepared for sending, OptiPub combines URL parameters in this order:

1. Global parameters
2. Resource parameters, when the message is based on a resource
3. Message, auto responder, or variation parameters

If the same parameter key appears in more than one place, the more specific value overrides the inherited value.

For example:

The final links use:

utm_source=resource-newsletter&utm_medium=email&utm_campaign=may-launch

The resource's utm_source overrides the global utm_source, while the global utm_medium and message-specific utm_campaign are kept.

📘

Inherited parameters are shown for reference in the URL Parameters form. They are not copied into the current item unless you explicitly add a parameter with the same key to override them.

Global URL Parameters

Global URL parameters are the defaults for all mailing content. Configure them in Admin > Settings > URL Parameters.

Use global parameters for values that should apply broadly, such as:

• utm_medium=email
• utm_source=optipub
• platform=optipub

Global parameters can also use dynamic macro values when the value should be personalized or resolved at send time.

If LiveConnect email tracking is enabled, OptiPub also adds the lctg={$lctg} parameter automatically at send time.

Resource URL Parameters

Resources can define their own URL parameters in the resource form under Email Settings > URL Parameters.

Resource parameters are inherited by messages created from that resource, including messages started with the resource's Send Message action.

Use resource parameters when a content item should carry its own tracking context, such as:

• utm_source=daily-article
• content_type=article
• newsletter=morning-brief

Resource parameters can also use macros when the value should be generated dynamically for each recipient.

Message URL Parameters

While creating or editing a message, click the URL Params icon in the content step to configure message-specific parameters.

Message parameters are the most specific layer for a regular message. They override both global and resource parameters with the same key.

For split tests, URL parameters are stored per variant, so each variant can use its own tracking values.

Message parameters can be static values or dynamic macro values selected from the macro picker.

Auto Responder URL Parameters

Auto responders and auto responder variations also support URL parameters.

• Configure parameters on the auto responder when the value should apply to the auto responder generally.
• Configure parameters on a variation when the value should apply only to that variation.

Variation-level parameters are the most specific layer for that variation.

Existing Link Parameters

If a link already contains a parameter key that OptiPub is going to apply, OptiPub replaces that key with the configured value. Other existing query parameters remain on the link.

For example, if a link starts as:

https://example.com/path?utm_source=old&keep=1

and the final configured URL parameters include:

utm_source=new&utm_medium=email

the sent link becomes:

https://example.com/path?keep=1&utm_source=new&utm_medium=email

Related Pages

• Messages
• Auto Responders
• Resources