Developer FAQ
Short answers to the questions developers ask most when integrating with Wishlist Hero, seeded from real support tickets. Each answer links to the reference with the detail.
Access and plans
Is there an API? Two. A JavaScript SDK on the storefront from Silver, and a REST API from Gold Plus. See JavaScript SDK reference and REST API reference.
Why do my SDK calls return { ok: false, status: 403 } ? The store’s plan does not include the SDK, or the app is disabled. Check the plan on the Plan page and that Enable App is on.
Where do I get an API key? Settings, REST API page, Generate API Key. It shows once; store it in your secret manager. See API authentication.
Data model
How are guests identified without an account? The wishlist lives in the cloud and the browser keeps a reference to it. Same browser, same list; login merges the guest list into the account list by product plus variant. See Guest lists and merge.
Where does the storefront get its settings? From a Shopify metafield the app publishes on every settings save, exposed as window.WishListHero_setting . If it is undefined , the App Configuration embed is off.
Where are items stored client side? In local storage under the app’s own keys: the wishlist hash, the items snapshot, and the customer ID. Treat local state as a cache; the server is the source of truth.
Does the app write product metafields? No. The app writes shop level metafields only (settings, icon config, translations). There is no per product wishlist count metafield.
Events and tracking
Which event fires when a shopper saves an item? Depending on your setup: the Klaviyo onsite metric Added To Wishlist (WH) , Meta Pixel AddToWishlist , GA4 add_to_wishlist , TikTok AddToWishlist , and the document event wishlist-hero-wishlist-updated . Full list: Events reference.
Do reminders fire events I can hook? Yes: Wishlisthero-pricedrop and Wishlisthero-lowstock fire into Klaviyo or Omnisend when one is your email provider.
Is there an event when an order is placed? No. There are no order or checkout events; attribution beyond add to cart happens in your analytics platforms from the events listed above.
Behavior
Does adding from the wishlist remove the item? Only if the merchant turned on Remove from wishlist after adding to cart. Default keeps the item. See Post add to cart behavior.
Can shoppers have more than one wishlist? No: one list per shopper, by design. Requests for named lists are common and worth registering with support.
Do share links expire? No. A share link shows the list’s current state for as long as the wishlist exists.
Operations
What happens to wishlists if the merchant uninstalls? Data is retained; reinstalling picks up where things left off. Shopper facing widgets stop when the app is gone.
How does GDPR deletion work? Shopify’s GDPR webhooks drive it: customer redaction deletes that shopper’s wishlist and actions; shop redaction deletes everything for the store. See GDPR in custom implementations.
Who do I contact about a missing endpoint? Support: apps@revampco.com. Feature requests from developers are triaged with the product roadmap.