> For the complete documentation index, see [llms.txt](https://wishlistsuite-1.gitbook.io/wishlistsuite-help-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wishlistsuite-1.gitbook.io/wishlistsuite-help-doc/installation-and-requirements/installation-guide.md).

# Installation Guide

Before your customers can start saving products, you need to "turn on" the engine. We’ve made this a one-click process, but we’ve also provided a manual route for total control over your Shopify 2.0 theme.

***

####  :jigsaw: Wishlist Embed

To activate wishlist functionality on your storefront, **WishlistSuite needs permission to inject the app into your product pages**. This is done using Shopify’s **App Embed feature**.

**Method A: The "Fast Track" (Recommended)**

The Use Case: For merchants who want to go live in under 10 seconds without touching a single line of code.

* Step 1: Click the "Enable App Embed" button on this page.
* Step 2: A new tab will open your Shopify Theme Editor.
* Step 3: The WishlistSuite app embeds will already be toggled "On." Simply hit Save in the top right corner.

<figure><img src="/files/uZVpj4KBpTu1PQ3qM25K" alt=""><figcaption></figcaption></figure>

{% embed url="<https://www.youtube.com/watch?v=6MisiaavJY4>" %}

**Method B: The Manual Toggle**

The Use Case: If you are already working in your theme or need to verify the installation manually.

1. Navigate to Online Store > Themes.
2. Click "Edit theme" on your current live theme.
3. On the Header, click the App Embeds icon (the third icon).
4. Locate Wishlist and Wishlist Page Launcher.
5. Toggle both to On and click Save.

<figure><img src="/files/M94Z2zc9XKRGunksHwum" alt=""><figcaption></figcaption></figure>

***

#### &#x20;:heart\_decoration: Wishlist Page Launcher Embed

This embed is necessary for the customers to view their wishlists. Here are the steps to enable it :

1. Go to Online Store > Themes.
2. Click Customize on your active theme.
3. On the left sidebar, click the App Embeds icon.
4. Toggle WishlistSuite Page Launcher to ON.
5. Click Save in the top right corner.

{% embed url="<https://youtu.be/kh9b113x--4?si=SDbXvE5iYPtDTZtS>" %}

***

### :gear: Additional Features

#### :page\_with\_curl: Wishlist Product Page App Block

To ensure the wishlist buttons appear correctly on your product pages, or to customise their appearance, position, you must add the app block to product template in your theme settings:

1. Go to Online Store > Themes.
2. Click Customize on your active theme.
3. Go to Product Page Template > Add Block
4. Go to Apps > Add Wishlist Button Block
5. Drag & drop the block at a position of your preference.
6. Click Save in the top right corner.

> If you have multiple Product Templates set up, then you'll need to add the block to each of the templates at the position you desire.

{% embed url="<https://youtu.be/SxQLc_7y_9o?si=HA8eBr3gbsR6HZ3R>" %}

***

#### Setup Checklist

* App Embed toggled ON in Shopify Theme Editor.
* "Add to Wishlist" button visible on a Product page.
* "Save for Later" visible in the Cart.
* Test a "Social Share" to ensure the link generates correctly.

***

#### Troubleshooting: "I don't see the buttons!"

If you’ve enabled the embeds but the buttons aren't appearing:

* Ensure your theme is Shopify 2.0 compatible.
* Check that the Wishlist Embed toggle is specifically "On" - this is the "brain" of the app.
* Reach out to our Live Chat for a 2-minute fix.

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://wishlistsuite-1.gitbook.io/wishlistsuite-help-doc/installation-and-requirements/installation-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.