> For the complete documentation index, see [llms.txt](https://wishlist.nativeappco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wishlist.nativeappco.com/wishlist-sharing.md).

# Wishlist Sharing

Customers can share their wishlist with friends using our share feature. Store owners can customise this feature using our advanced editor.

### Turn on Wishlist Sharing

Wishlist Sharing can be turned on from the [Settings](https://admin.shopify.com/apps/fish-wishlist/app/settings) tab. Once **Share Wishlist button** is on, you can also turn on **Personalise shared links** so customers can add their name and a message to the wishlists they share.

<figure><img src="https://1134778209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMp2ekCAtVgFUnsQlGWfX%2Fuploads%2Fgit-blob-477c11bd5f78c9736752b30d7037133854472d5f%2Fwishlist-sharing-settings.gif?alt=media" alt="Turning on Share Wishlist button and Personalise shared links in Settings"><figcaption></figcaption></figure>

### How It Works

{% embed url="<https://youtu.be/3mIYTSDwsn4>" %}
Personalised wishlist sharing in the wishlist drawer
{% endembed %}

1. **Share the wishlist**
   * The customer opens a wishlist in the drawer and clicks **Share List**. Fish Wishlist creates a public link to that wishlist.
   * Sharing needs a logged-in customer and at least one item in the list.
2. **Add a name and message** (with **Personalise shared links** on)
   * **Your name** and **Message (optional)** appear above the share buttons. The name is prefilled with the customer's first name and can be changed (for example "Mum & Dad").
3. **Send or copy the link**
   * **Send Share Link** opens the device's share sheet (email, messages, social). With personalisation on, the customer's message, or "*{name}* shared their wishlist with you" when there is no message, is sent with the link.
   * **Copy Share Link** copies the link.
   * Pressing either button saves the name and message, so they appear on the shared wishlist page.
4. **Stop sharing**
   * The customer can click **Cancel** to make the wishlist private again. The public link stops working.

{% hint style="info" %}
You can change every label, and the "*{name}* shared their wishlist with you" text, in **Settings → Texts & translations → Share Wishlist**. Keep `{name}` where the sharer's name should go.
{% endhint %}

### Show the name and message on the shared wishlist page

With personalisation on, the shared wishlist page template can use:

| Liquid                                | What it holds                                     |
| ------------------------------------- | ------------------------------------------------- |
| `wishlist.title`                      | The wishlist's name, for example "Christmas list" |
| `wishlist.metadata.value.sharer_name` | The name the customer entered                     |
| `wishlist.metadata.value.message`     | The customer's message                            |
| `items`                               | The wishlist's products (variants)                |

New installs show the name and message by default. If your store installed Fish Wishlist before November 2026, add this to your shared wishlist page template (see [Accessing the Custom Page Editor](#accessing-the-custom-page-editor-advanced) below), under the heading:

```liquid
{% assign share = wishlist.metadata.value %}
{% if share.sharer_name != blank %}
  <p class="fish-shared-by">Shared by {{ share.sharer_name | escape }}</p>
{% endif %}
{% if share.message != blank %}
  <blockquote class="fish-shared-message">{{ share.message | escape | newline_to_br }}</blockquote>
{% endif %}
```

{% hint style="warning" %}
Always output customer-entered text with `| escape`, including `wishlist.title`.
{% endhint %}

***

### Accessing the Custom Page Editor (advanced)

<figure><img src="https://1134778209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMp2ekCAtVgFUnsQlGWfX%2Fuploads%2FyBfL8kPJflQOfbsMHbfm%2Fimage.png?alt=media&amp;token=64be1032-a315-4396-a884-591236594f69" alt=""><figcaption></figcaption></figure>

Fish Wishlist provides a **hidden editor** for advanced users. You can manage your wishlist page directly through the following link:

➡️ [Wishlist Page Editor (Advanced Access)](https://admin.shopify.com/apps/fish-wishlist/app/pages)

> **Note:** This link is hidden in your app admin. Use it only if you’re familiar with theme development and advanced customization.

### Editing the Shared Wishlist Page Template

The shared wishlist page uses a **generic grid-based layout**, which is designed to work across Shopify themes.

You can fully customize this page via the hidden editor and insert any theme-compatible code. Below is a sample template for rendering the shared wishlist using Shopify’s Dawn theme structure.

#### Sample Code for Dawn Theme:

```liquid
{{ 'component-card.css' | asset_url | stylesheet_tag }}
{% assign share = wishlist.metadata.value %}
<div class="collection page-width">
    <h2> {{ wishlist.title | default: "Shared wishlist" | escape }}</h2>
    {% if share.sharer_name != blank %}
      <p>Shared by {{ share.sharer_name | escape }}</p>
    {% endif %}
    {% if share.message != blank %}
      <blockquote>{{ share.message | escape | newline_to_br }}</blockquote>
    {% endif %}
    <ul class="grid product-grid grid--2-col-tablet-down grid--4-col-desktop"> 
      {% for item in wishlist.items.value %}
      <li class="grid__item">
        {% render 'card-product',
          card_product: item.product,
          media_aspect_ratio: "adapt",
          image_shape: "default",
          show_secondary_image: true,
          show_vendor: true,
          show_rating: true,
          skip_styles: false,
          section_id: section.id,
          quick_add: false
        %}
        </li>
      {% endfor %}
    </ul>
</div>

```

#### Adding a "Share button" to your Wishlist page

To allow your customers to easily share their wishlists, you can add a dedicated "Share button" to their wishlist page. This button will generate a shareable link to their public wishlist.

You can implement this feature by adding the following code snippet to your wishlist page template:

Code snippet

```
{% if metadata.sharedWishlist.handle != blank %}
<fish-wishlist-share-button
  data-url="https://<MYSTORE.COM>/apps/fish-wishlist/shared-wishlist/{{ metadata.sharedWishlist.handle }}"
  data-title="{{ metadata.sharedWishlist.title }}"
  title="{{ metadata.sharedWishlist.title }}">
  <button class="fish-wishlist-share-button fish-wishlist-button--link button--share">
    <svg width="13" height="12" viewBox="0 0 13 12" class="icon icon-share" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false"> <path d="M1.625 8.125V10.2917C1.625 10.579 1.73914 10.8545 1.9423 11.0577C2.14547 11.2609 2.42102 11.375 2.70833 11.375H10.2917C10.579 11.375 10.8545 11.2609 11.0577 11.0577C11.2609 10.8545 11.375 10.579 11.375 10.2917V8.125" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round"></path> <path fill-rule="evenodd" clip-rule="evenodd" d="M6.14775 1.27137C6.34301 1.0761 6.65959 1.0761 6.85485 1.27137L9.56319 3.9797C9.75845 4.17496 9.75845 4.49154 9.56319 4.6868C9.36793 4.88207 9.05135 4.88207 8.85609 4.6868L6.5013 2.33203L4.14652 4.6868C3.95126 4.88207 3.63468 4.88207 3.43942 4.6868C3.24415 4.49154 3.24415 4.17496 3.43942 3.9797L6.14775 1.27137Z" fill="currentColor"></path> <path fill-rule="evenodd" clip-rule="evenodd" d="M6.5 1.125C6.77614 1.125 7 1.34886 7 1.625V8.125C7 8.40114 6.77614 8.625 6.5 8.625C6.22386 8.625 6 8.40114 6 8.125V1.625C6 1.34886 6.22386 1.125 6.5 1.125Z" fill="currentColor"></path> </svg>
    <span>Send Share Link</span>
  </button>
  <button class="fish-wishlist-share-button button--copy">
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="4 3 12 14"><path fill-rule="evenodd" d="M6.515 4.75a2 2 0 0 1 1.985-1.75h3a2 2 0 0 1 1.985 1.75h.265a2.25 2.25 0 0 1 2.25 2.25v7.75a2.25 2.25 0 0 1-2.25 2.25h-7.5a2.25 2.25 0 0 1-2.25-2.25v-7.75a2.25 2.25 0 0 1 2.25-2.25h.265Zm1.985-.25h3a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-3a.5.5 0 0 1-.5-.5v-1a.5.5 0 0 1 .5-.5Zm-1.987 1.73.002.02h-.265a.75.75 0 0 0-.75.75v7.75c0 .414.336.75.75.75h7.5a.75.75 0 0 0 .75-.75v-7.75a.75.75 0 0 0-.75-.75h-.265a2 2 0 0 1-1.985 1.75h-3a2 2 0 0 1-1.987-1.77Z"></path></svg>
    <span>Copy Share Link</span>
  </button>
</fish-wishlist-share-button>
{% endif %}
```

**Important Note:** These share buttons will only be visible to a customer if they have previously enabled the shared wishlist feature using the dedicated button within the wishlist drawer.

#### 🛠 Customization Tips:

* You can use `card-product` or any custom snippet from your current theme.
* Adjust the grid layout, headings, and styling to better fit your brand.
* Use conditional logic to show different views for empty wishlists or logged-in users.
