Browse Plugins

Product Mapping

All Lemon Squeezy for WordPress docs Get Lemon Squeezy for WordPress

What is Product Mapping?

Each WooCommerce product must be linked to a Lemon Squeezy product variant. This tells the plugin which Lemon Squeezy product to charge for each item.

Option A: One-Click Product Sync (Recommended)

The fastest way to connect your products – the plugin pulls everything from Lemon Squeezy automatically.

1

Sync Products From Lemon Squeezy

  1. Go to WooCommerce → Lemon Squeezy in the admin menu
  2. Find the “Quick Actions” section
  3. Click “Sync Now” next to Sync Products
  4. The plugin pulls all your products and variants from Lemon Squeezy
  5. You’ll see a success message like: “6 products and 8 variants synced successfully”

Product Sync Button in Quick Actions

Screenshot: Click “Sync Now” to pull all products from Lemon Squeezy

2

Map to WooCommerce Products

After syncing, the plugin replaces the manual Variant ID text field with a dropdown on every product.

For Simple Products:

  1. Go to Products → All Products
  2. Click to edit any product
  3. Scroll down to Product Data → General tab
  4. You’ll see a “Lemon Squeezy Variant” dropdown
  5. The dropdown lists all your LS products and variants with names and prices – e.g., “Lemon Squeezy for WooCommerce: Yearly – $39.00 (ID: 48291)”
  6. Select the matching variant and click “Update”

Lemon Squeezy Variant Dropdown on Product Edit Page

Screenshot: Select your Lemon Squeezy variant from the dropdown on the General tab

For Variable Products:

  1. Edit the variable product
  2. Go to Product Data → Variations
  3. Expand any variation
  4. You’ll see an “LS Variant” dropdown on each variation
  5. Select the matching Lemon Squeezy variant for each variation

LS Variant Dropdown on Product Variation

Screenshot: Each variation has its own “LS Variant” dropdown

No dropdown? Sync your products first. Go to WooCommerce → Lemon Squeezy and click Sync Now.

Fallback logic: If a variation doesn’t have its own variant set, the plugin uses the parent product’s variant from the General tab.

Option B: Manual Product Mapping

If you prefer to map products manually, follow these steps.

1

Get Variant ID From Lemon Squeezy

  1. Log in to Lemon Squeezy dashboard
  2. Go to Products
  3. Click the 3 dots menu on your product variant
  4. Select “Copy variant ID”
Lemon Squeezy Product Creation and Product Variant ID

Screenshot: Lemon Squeezy Product Creation and Product Variant ID

2

Paste Variant ID in WooCommerce

  1. In WordPress, go to Products → All Products
  2. Click to edit a product
  3. Scroll down to the “Product Data” section
  4. Look for the “Lemon Squeezy Variant ID” field
  5. Paste your Variant ID in this field
  6. Click “Update” to save
  7. Repeat for all products
WooCommerce Product Edit - Lemon Squeezy Variant ID Field

Screenshot: Paste Your Variant ID in the Product Data Section

Variable products? Each variation has its own Variant ID field. Edit variations individually and paste the matching ID. If a variation has no ID, the plugin falls back to the parent product’s ID.