---
title: "Add a URL Parameter to a Link in an HTML Email"
slug: "add-parameter-to-a-link-manually"
updated: 2026-02-05T16:21:29Z
published: 2026-02-05T16:21:29Z
canonical: "docs.mapp.com/add-parameter-to-a-link-manually"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add a URL Parameter to a Link in an HTML Email

## Goal

Manually add a parameter to a link in an email to pass dynamic or static values during sendout.

## Background Information

URL parameters can include personalization placeholders and Mapp Engage variables, which are resolved during sendout to pass recipient- or message-specific data.

### Example

You want to personalize a shopping link by appending the contact’s ID to the URL. Your e-commerce platform uses this ID to customize the user experience.

**Original Link**

```xml
<a href="www.sportswear.com">Shop Online</a>
```

**Modified Link with Parameter**

```xml
<a href="www.sportswear.com/?contactID=<%${user['ID']}%>">Shop Online</a>
```

**Resulting Link in Recipient's Inbox**

```xml
www.sportswear.com/?contactID=14182654230
```

## Procedure

1. Open the email in the **Compose Message** window.
2. Locate the link you want to modify.
3. Add a parameter to the query part of the URL (after the `?` symbol):
  - Use a personalization placeholder to insert a value from the contact profile.
  - Use a Mapp Engage variable to insert message-, group-, or system-specific values.
4. Save the email.

A tag used to insert personalized content, such as names or order details, into messages in Mapp Engage.

## Related

- [Pass Data via URL Parameters in Email Links](/parameters-in-message-links.md)
- [Mapp Engage Variables](/messages-mapp-engage-variables.md)