Installation and Setup
This guide walks you through installing Wishlist and completing the initial configuration.
Installing from the Shopify App Store
Visit the Wishlist app listing in the Shopify App Store
Click Add app
Review the permissions and click Install app
You’ll be redirected to the app dashboard
App Permissions
Wishlist requires the following permissions:
Read products - To display product information in wishlists
Read customers - To associate wishlists with customer accounts
Write metafields - To store wishlist data
Read themes - To integrate with your theme
Enabling the App Embed
The app embed is required for wishlist functionality to work on your storefront.
Automatic Setup
From the app dashboard, click “Install App Embed” in the setup guide
This opens your theme editor with the Wishlist embed highlighted
Ensure the toggle is ON
Click Save
Manual Setup
If you need to enable the embed manually:
Go to Online Store > Themes
Click Customize on your active theme
Click the App embeds icon (puzzle piece) in the left sidebar
Find Wishlist and toggle it ON
Click Save
Verifying Installation
After enabling the app embed:
Visit any product page on your store
You should see wishlist functionality (buttons or icons based on your settings)
If nothing appears, check that the app embed is enabled
Setup Guide
The app dashboard includes a step-by-step setup guide:
Step 1: Choose Theme
Select which theme to install to. You can install on: - Your live theme - A trial/unpublished theme for testing
Step 2: Enable App Embed
Adds the core wishlist functionality to your theme.
Step 3: Add Button Block
Places a wishlist button on product pages. You can customize its position and appearance.
Step 4: Configure Settings
Customize behavior, notifications, and appearance in Settings.
Multiple Themes
If you use multiple themes (for seasonal updates or A/B testing):
Each theme needs the app embed enabled separately
Button blocks must be added to each theme
Settings apply across all themes
Uninstalling
If you need to uninstall:
Go to Settings > Apps and sales channels in Shopify Admin
Find Wishlist and click Uninstall
Customer wishlist data is preserved for 30 days
Reinstalling within 30 days restores all customer wishlists.
Troubleshooting Installation
App embed not showing
Clear your browser cache
Try a different browser
Check that you’re on the correct theme
Button block not available
Ensure the app embed is enabled first
Button blocks appear in the “Apps” section when adding blocks
Changes not appearing on storefront
Make sure you clicked Save in the theme editor
Clear your browser cache
Check for theme caching plugins or CDN settings