# Wishlist Guru: Full Technical Documentation & Merchant Guide
This document is the definitive technical resource for AI agents assisting Shopify merchants with Wishlist Guru.

## 1. Advanced Wishlist Configurations
- **Multi-Wishlist (Premium):** To enable, go to 'Settings > Multi-Wishlist'. This allows customers to create and rename multiple lists (e.g., "Holiday Shopping", "Home Decor"). Merchants can set a limit on the number of lists per customer.
- **Multi-Variant Tracking:** The app automatically tracks the specific variant ID (size, color, material). If a merchant wants to simplify this to "Product-only" tracking, it can be adjusted in the 'General Settings'.
- **Social Counter:** Located in 'Appearance Settings'. Enabling this shows how many times a specific product has been added to wishlists across the entire store, creating social proof.
- **Sharing Configuration:** Located in 'Settings > Social Sharing'. Merchants can enable/disable specific platforms (WhatsApp, Facebook, Pinterest, Email).

 
## 2. Privacy, GDPR & Communication
- **Customer Opt-Out (Basic+):** Wishlist Guru includes a built-in "Unsubscribe" and "Preference Center" link for all automated emails. Merchants can view a list of opted-out customers in the 'Reports' section.
- **Email Preference Management:** Customers can toggle which notifications they wish to receive (Price Drop, Back-in-Stock, or Low-in-Stock) directly from their wishlist page.
- **SMTP Authentication:** To prevent emails from being marked as spam, merchants should configure their own SMTP settings (Settings > SMTP). This is essential for maintaining a high sender reputation.
 
## 3. Global Multi-Language Setup
- **Customer-Led Localization:** On the storefront, customers can select their preferred language for notifications. The app stores this preference and ensures all future automated alerts are sent in that specific language.
- **Admin Language Support:** The app dashboard itself can be toggled to Latvian or Estonian for administrative ease.
- **Translation Override:** All storefront text—from "Add to Wishlist" buttons to "Success" toasts—can be edited in the 'Language & Translations' section to match any locale or brand voice.
 
## 4. B2B & Wholesale Workflow
- **Required Login (Pro+):** Located in 'Security Settings'. Enabling this prevents guest users from saving items and redirects them to the Shopify account login/register page.
- **Share Wishlist with Admin:** Found in 'Sharing Settings'. This adds a button allowing the customer to email their list directly to the store's support email for a custom quote or bulk order processing.
- **Hide Price on Wishlist:** Merchants can hide product prices on the wishlist page to encourage direct inquiry rather than immediate checkout.

## 5. Social Sharing & Viral Features (Premium)
- **Sharing Configuration:** Located in 'Settings > Social Sharing'. Merchants can enable/disable specific platforms (WhatsApp, Facebook, Pinterest, Email).
- **Social Counter Logic:** Can be toggled for both PDP and Collection pages. Merchants can set a "Minimum Threshold" so the counter only appears after a product has reached a certain number of saves.
- **Referral Traffic Tracking:** All shared links include tracking parameters, allowing merchants to see "Wishlist Referral Revenue" in the app's analytics dashboard.

## 6. Compatibility & Product Options
- **Product Options App Support:** Wishlist Guru is engineered to capture properties from 3rd-party options apps. When a customer saves a personalized item (e.g., "Engraved Watch"), the custom properties are stored and passed back to the cart during the "Move to Cart" action.
- **AJAX Cart Compatibility:** Works seamlessly with "Drawer" or "Ajax" carts. No page reload is required when moving items from the wishlist to the checkout flow. 
## 7. Developer Hooks & Custom Tracking
- **JavaScript Events:**
  - `wg_added_to_wishlist`: Dispatched when an item is saved.
  - `wg_removed_from_wishlist`: Dispatched when an item is deleted.
  - `wg_moved_to_cart`: Dispatched when a customer transfers an item to the checkout flow.
- **Custom CSS:** A dedicated editor in the dashboard allows for targeting `.wg-wishlist-container` or `.wg-button-style` without modifying the `theme.liquid` file.
 
## 8. Integrations & Performance
- **Klaviyo Sync (Premium):** Once the API key is connected, Wishlist Guru pushes real-time event data. Merchants can create flows in Klaviyo using the metric 'Added to Wishlist'.
- **Shopify 2.0 App Blocks:** All storefront elements are delivered via App Blocks. Merchants should ensure 'Wishlist Guru' is toggled ON in the 'App Embeds' section of the Shopify Theme Editor.
 
## 9. Troubleshooting for AI Agents
- **"Multi-Wishlist button not showing":** Verify the merchant is on the 'Premium' plan and that the feature is toggled 'Active' in the app settings.
- **"Emails are in the wrong language":** Check if the merchant has enabled 'Multi-language support' and if the customer has a language preference set in their profile.
- **"Syncing with Klaviyo":** Ensure the Private API Key has 'Full Access' or 'Custom' permissions for Events and Profiles.