---
title: How to Add Customer Metafield Values to Shared Wishlist URLs (Affiliation Customer Metafield)
description: "Want to know *who* is sharing wishlists from your store? With Wishlist Guru's **Affiliation Customer Metafield** feature, you can automatically attach a customer-specific value — such as an Affiliate ID, Membership ID, or referral code — to every shared wishlist…"
url: "https://wishlist-guru.webframez.com/docs/wishlist-affiliate-tracking-metafield/"
updated: "2026-07-15"
category: Premium Features
---

# How to Add Customer Metafield Values to Shared Wishlist URLs (Affiliation Customer Metafield)

Want to know *who* is sharing wishlists from your store? With Wishlist Guru's **Affiliation Customer Metafield** feature, you can automatically attach a customer-specific value — such as an Affiliate ID, Membership ID, or referral code — to every shared wishlist URL. The value can also be displayed on the shared wishlist page itself, including the product cards and page title.

This makes it easy to track referrals, reward affiliates, personalize shared pages, and connect wishlist activity back to individual customers.

---

## What This Feature Does

When a customer shares their wishlist, Wishlist Guru generates a shareable URL. With this feature enabled, the app reads a value from a **Shopify customer metafield** and appends it to that URL as a query parameter.

For example, instead of a standard share link:

```
https://your-store.myshopify.com/apps/wg-wishlist?id=12345&name=John
```

the shared link becomes:

```
https://your-store.myshopify.com/apps/wg-wishlist?id=12345&name=John&devplan=Premium
```

Here, `devplan` is the parameter name you choose, and `Premium` is the value pulled from the customer's metafield.

## Common Use Cases

- **Affiliate tracking** — attach each customer's affiliate ID to shared wishlists so you can attribute sales generated from shared links.
- **Membership tiers** — show a customer's plan or tier (e.g., *Premium*, *Gold*) on their shared wishlist page.
- **Referral programs** — pass referral codes through wishlist shares automatically.
- **Custom attribution** — track any custom customer attribute you store in Shopify.

---

## Prerequisite: Create a Customer Metafield in Shopify

Before configuring the feature, you need a customer metafield definition in your Shopify admin:

1. Go to **Shopify Admin → Settings → Custom data → Customers**.
2. Click **Add definition**.
3. Create the customer metafield you want to use in the wishlist share URL (for example, a metafield with the key `devplan` under the `custom` namespace).
4. Make sure your customers have values saved in this metafield.

---

## How to Configure the Feature

In your Shopify admin, open **Wishlist Guru → General Settings** and scroll to the **Affiliation Customer Metafield** section.

![](https://wishlist-guru.webframez.com/wp-content/uploads/2026/07/image-2-1024x435.png)

### Step 1: Enable the Feature

Turn on the **Affiliation Customer Metafield** toggle.

### Step 2: Enter the Customer Metafield Name

In the **Enter Customer Affiliate Metafield Name** field, enter only the **metafield key** you created in Shopify.

For example, if your full metafield reference is:

```
customer.metafields.custom.devplan
```

enter only:

```
devplan
```

The app automatically expands it to:

```
{{ customer.metafields.custom.devplan }}
```

**Note:** Enter only the metafield key. Do **not** include `customer.metafields` or the namespace.

### Step 3: Enter the Query String Variable Name

In the **Enter Query String Variable Name** field, choose the name of the URL parameter that should appear in the shared wishlist link — for example:

```
devplan
```

This generates shared wishlist URLs like:

```
https://your-store.myshopify.com/apps/wg-wishlist?id=12345&name=John&devplan=Premium
```

Where:

- `devplan` → the URL parameter (your Query String Variable Name)
- `Premium` → the value retrieved from the customer's metafield

You can choose any parameter name, but we recommend using the same name as your metafield key for consistency.

That's it — once saved, every wishlist shared by a logged-in customer will include their metafield value in the URL.

---

## FAQ

**What happens if a customer doesn't have a value in the metafield?** If the metafield is empty for a customer, the parameter simply won't carry a value in their shared link.

**Does this work for guest (not logged-in) visitors?** No. The feature reads data from the Shopify customer record, so it applies to logged-in customers who have the metafield set.

**Can I use a different parameter name than my metafield key?** Yes. The Query String Variable Name is independent of the metafield key — but keeping them the same makes your links easier to read and debug.

**Where does the value appear?** In the shared wishlist URL, and optionally on the shared wishlist page — including the product cards and the page title.

---

Need help setting this up? Reach out to the Wishlist Guru support team and we'll be happy to assist.

  Views: 201
