Troubleshooting

Quantity Pricing menu missing

Plugin not installed or registered

Install package, add to medusa-config.ts under plugins, restart Medusa

Admin page blank or error

Stale plugin build

Rebuild plugin, restart backend, clear browser cache

Cannot save rule – Product ID required

Empty product ID on global page

Enter valid prod_ ID or use product page widget

Rule saved but not in table

Wrong filter / cache

Refresh page; verify product ID

Store API returns empty list

No rules for product + currency

Create matching rules

Variant tiers not returned

variant_id not in request

Pass variant_id; or use product-level rules

Wrong tier applied

Overlapping quantity ranges

Redesign tiers; highest min_qty wins

Customer sees catalog price only

Storefront not integrated

Call Store API; apply unit_price in cart

Discount tier shows wrong price

Missing catalog or reference price

Set variant price in Medusa or reference list price

“No list price” in Admin

No Medusa price for currency

Add variant price or reference field

Percentage validation error

Value > 100

Use 1-100 for percentage

Max qty validation error

Max less than min

Set max ≥ min or leave max empty

Unit price is $0.00

Discount larger than base

Reduce discount; check base price

Migration failed

Database not migrated

Run npx medusa db:migrate

Module not found

Duplicate module entry

Plugin under plugins only, not modules

Rules deleted with product

Auto cleanup (expected)

Export rules before deleting products

Edit does not save

Validation error in drawer

Read error message; fix invalid fields

calculated_price missing

quantity not in API request

Add quantity query parameter

Store API 401

Missing publishable API key

Add x-publishable-api-key header

Admin API 401

Session expired

Re-login to Admin

B2B tier not applied

customer_group_id not passed

Pass group from logged-in customer

Region tier not applied

region_id not passed

Pass region in Store API

Multi-currency wrong tier

Rule in different currency

Create per-currency rules

Fixed tier ignores catalog

By design

Fixed uses tier value directly

Open-ended tier not matching

Min qty too high

Check min for “51+” style tiers

Duplicate tiers same range

Manual error

Delete duplicate; keep one rule