Track and Identify Viewers with URL Parameters (Email, UTM, and Custom)

Overview

Walnut supports URL parameters that you can add to any demo, playlist, or deal room link.

These parameters let you:

• Identify individual viewers automatically

• Track sources, referrers, and campaigns

• Personalize the experience and enrich your analytics

You can append email identifiers, UTM tags, or custom parameters to either the short or long version of a Walnut link.

Short and Long URLs in Walnut

When you share a Walnut demo, playlist, or deal room, the platform automatically generates a shortened URL. This is the default format you’ll copy when sharing with viewers.

When opened in a browser, the short link seamlessly redirects to a long-form URL that includes session details and display parameters.

• Example Short URL:

https://wlnt.io/s/zhJOUC

• Example Expanded (Long-Form) URL:

https://app.teamwalnut.com/player/?demoId=92fc28c0-ced2-402f-b4d2-0a3968d39370&screenId=9b62e7de-2f94-445d-a2fb-7877eb590d98&showGuide=true&showGuidesToolbar=true&showHotspots=true&source=unknown

😎 Note: If your company uses a custom domain, you’ll see your subdomain (e.g., demos.crunchy.ai) instead of app.teamwalnut.com.

Formatting URL Parameters

Before diving into specific parameter types, it’s important to understand the basic rules of formatting URL parameters. These rules apply to all parameters — whether you’re using email identifiers, UTM tags, or custom fields.

The basics:

1. Start the first parameter with a ?.

   Example: https://wlnt.io/s/zhJOUC?email=shellvis.ca@crunchy.ai

2. Add additional parameters using &.

   Example with multiple parameters: https://wlnt.io/s/zhJOUC?email=jane@example.com&utm_source=linkedin&utm_campaign=demo_launch

3. Only use one ? per link — all other parameters must use &.

🗒️ Notes:

• Every Walnut link can include one or more parameters to capture additional context.

• Parameters are always added to the end of the URL.

• They work with both the shortened links (e.g., https://wlnt.io/s/zhJOUC) and the expanded long‑form URLs.

• There should only ever be one question mark ? in a link. All other parameters should be joined with &.

Identifying Viewers with Email Parameters

When sharing Walnut assets through your marketing or sales engagement platforms, you can use dynamic email parameters to automatically pass the recipient’s email address into the demo link.

Walnut supports the templating languages of each platform, so you don’t need to manually insert the email. The platform automatically replaces the merge tag with the recipient’s actual email when the message is sent.

To add email parameters to a Walnut URL:

1. Copy your Walnut short link.
   Example: https://wlnt.io/s/zhJOUC
2. Add the email parameter for your platform.
   Append ?email=<merge_tag> to the link.
   (See the table below for the correct merge tag for each platform.)
3. Send the link through your platform.
   The merge tag is automatically replaced with the recipient’s email when the message is sent.

Email Parameter Example:

Suppose you are sending a Walnut demo link via HubSpot. Instead of manually typing each recipient’s email, use the HubSpot merge tag:

https://wlnt.io/s/zhJOUC?email={{contact.email}}

When the email is sent, {{contact.email}} is automatically replaced with the recipient’s real email address.

Email Parameters: Quick Reference

UTM Parameters

Track where traffic is coming from and how viewers got to your demo. By appending UTM parameters to your Walnut links, you can measure demo performance across campaigns, emails, and referral sources.

To add UTM tag parameters to a Walnut URL:

1. Copy your Walnut short link.
   Example: https://wlnt.io/s/zhJOUC
2. Add UTM parameters to track traffic.
   Append ?utm_source=<source>&utm_medium=<medium>&utm_campaign=<campaign> Example: https://wlnt.io/s/zhJOUC?utm_source=app&utm_medium=email&utm_campaign=launch
3. Send or share the link.
   When opened, the short link automatically expands into a long‑form version with the same UTM parameters included.

UTM Parameter Example:

Short URL (default from Walnut):

https://wlnt.io/s/zhJOUC?utm_source=app&utm_medium=email&utm_campaign=launch

Expanded long-form version (auto-generated when the short link opens):

https://app.teamwalnut.com/player/?demoId=92fc28c0-ced2-402f-b4d2-0a3968d39370&utm_source=app&utm_medium=email&utm_campaign=launch

UTM Parameters: Quick Reference

Custom Parameters

Add any additional fields relevant to your tracking or personalization logic. Custom parameters let you pass extra context into your Walnut links — such as campaign names, personas, or account identifiers.

To add custom parameters to a Walnut URL:

1. Copy your Walnut short link.
   Example: https://wlnt.io/s/zhJOUC
2. Add one or more custom parameters to the end of the URL.
   Append ?custom_param=<value>&custom_param=<multi-word-value>&custom_param=<value>
3. Send or share the link.
   When opened, the short link automatically expands into a long‑form version with the same custom parameters included.

Custom Parameter Example:

Short URL:

https://wlnt.io/s/zhJOUC?campaign=linkedin&persona=marketing-lead

Expanded URL:

https://app.teamwalnut.com/player/?demoId=92fc28c0-ced2-402f-b4d2-0a3968d39370&campaign=linkedin&persona=marketing-lead

Custom Query Parameters: Quick Reference

Use the table below to standardize custom parameters across your team. Following these conventions will make your Walnut assets easier to track, analyze, and connect with downstream tools like your CRM or marketing automation platform.

Advanced Options: Passing Email Parameters Dynamically

In addition to email parameters, UTM parameters, and custom parameters, there are advanced methods for dynamically passing viewer emails into Walnut URLs. These methods require collaboration with your web development or marketing ops team.

Advanced Method 1: Pass an Email via Shared URL

Use this approach when distributing Walnut demo or playlist links through internal systems or marketing tools that support dynamic macros.

1. Copy your Walnut demo link.
2. Insert your platform’s email macro in place of the email value.
   Example: https://wlnt.io/s/abc123?email={{user.email}}
3. Distribute the link via your system — the macro will be replaced with each viewer’s email at send time.

Advanced Method 2: Pass an Email via Website Embed

Use this approach when embedding Walnut demos or playlists directly into a company website, landing page, or customer portal.

1. Retrieve the viewer’s email from your hosting domain (e.g., via login, cookie, or SSO).
2. Append the email parameter to the embed code.
   Example: </iframe>
   <iframe src="https://app.teamwalnut.com/player/?demoId=92fc28c0-ced2-402f-b4d2-0a3968d39370&showGuide=true&showGuidesToolbar=true&showHotspots=true&source=app&email=user@company.com" style="border:0" allow="fullscreen" allowfullscreen="true" loading="eager" name="walnut_iframe"sandbox=" allow-scripts allow-same-origin allow-popups allow-forms allow-downloads allow-popups-to-escape-sandbox" title="Walnut embedded demo" width="100%" height="100%" frameborder="none"></iframe>
   
3. Deploy the embed on your site — the email will be passed dynamically for each logged‑in user.

Summary: Best Practices for URL Parameters

To get the most value from URL parameters in Walnut, follow these best practices:

• Always use clear, consistent parameter names (e.g., campaign, persona, region).
• Limit parameters to what you need — avoid overloading links with unnecessary fields.
• Keep values analytics‑friendly (lowercase, no spaces, use underscores or hyphens).
• Test your links in Walnut and connected tools before sharing with prospects or customers.
• Document your parameter conventions so Marketing, Sales, and RevOps stay aligned.
• Respect privacy — avoid sending sensitive PII (stick to email, campaign IDs, persona, etc.).