E-Commerce Requires WooCommerce

Headless Wishlist

Simple, lightweight wishlist for headless WooCommerce stores. Stores wishlist data in user meta (no custom tables). Includes automatic stale product cleanup, duplicate detection, and admin analytics for most-wishlisted products.

View Source

Features

Per-user product wishlists via REST API

User meta storage — no custom database tables

Automatic stale product cleanup on read

Duplicate detection (409 Conflict on add)

Configurable max items per wishlist

Admin analytics: top 20 most wishlisted products

API Endpoints

Method	Path	Description
GET	/headless-wishlist/v1/items	List user's wishlist
POST	/headless-wishlist/v1/items	Add product to wishlist
DELETE	/headless-wishlist/v1/items/{product_id}	Remove product
DELETE	/headless-wishlist/v1/items	Clear entire wishlist

API Example

# Add product to wishlist
curl -X POST https://store.example.com/wp-json/headless-wishlist/v1/items \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "Content-Type: application/json" \
  -d '{"product_id": 156}'

# List wishlist
curl https://store.example.com/wp-json/headless-wishlist/v1/items \
  -H "Authorization: Bearer eyJhbGci..."

{
  "items": [
    {
      "product_id": 156,
      "title": "Classic Cotton Shirt",
      "price": "29.99",
      "image": "https://store.example.com/wp-content/uploads/shirt.jpg",
      "added_at": "2026-04-09T10:30:00Z"
    }
  ],
  "count": 1,
  "max_items": 100
}

FAQ

Why user meta instead of a custom table?

User meta keeps the plugin lightweight with zero database migrations. For typical wishlist sizes (under 100 items), the performance is identical and the data is automatically cleaned up when a user is deleted.