# Pain-Point Taxonomy

Use this fixed category list when clustering negative and mixed mentions so coding stays consistent across runs. For each category: how buyers phrase it, whether it usually signals a **PRODUCT** fix or a **LISTING-COPY** fix, and the proactive copy change that defuses it before it becomes a bad review.

Routing rule of thumb: *"Would the buyer still be unhappy if the page had set the right expectation?"* Yes -> PRODUCT. No -> COPY. Often BOTH: fix the copy this week, fix the product next run.

---

## 1. Quality / Durability

- **Typical phrasings:** "broke after a week," "stitching came undone," "feels cheap," "stopped working," "flimsy," "wore out fast."
- **Usually signals:** **PRODUCT.** Durability is rarely an expectation problem — a buyer paying any price expects it to last a reasonable time.
- **Proactive copy change:** Don't paper over it. If lifespan is genuinely limited (consumable, light-duty), state realistic use and care ("hand-wash to preserve coating; rated for ~300 charge cycles"). Add a warranty/returns line so the page signals confidence. Avoid superlatives ("indestructible") that set up the fall.

## 2. Sizing / Fit

- **Typical phrasings:** "runs small/large," "size up/down," "not true to size," "too tight in the shoulders," "doesn't fit my [device/wall/monitor]."
- **Usually signals:** **BOTH.** The pattern may need a product change, but most sizing pain is fixable today with a better chart.
- **Proactive copy change:** Add a measured size chart in cm/in (not just S/M/L), a fit note ("runs ~1 size small — order up"), model height/size worn, and real product dimensions with a scale reference. For compatibility products, state exact tolerances ("fits monitors 8-32mm thick").

## 3. Shipping / Packaging

- **Typical phrasings:** "arrived damaged," "box was crushed," "no protective wrap," "leaked in transit," "took forever," "missing parts."
- **Usually signals:** **PRODUCT/OPS** for packaging and missing-parts (your fault); **out-of-scope** for pure courier speed (not your control, but recurring delays may need a carrier/fulfillment change).
- **Proactive copy change:** Copy can't fix a crushed box, but it can set delivery-time expectations honestly and confirm what's in the box ("includes: unit, USB-C cable, 2 clips, manual") so "missing parts" reviews from confused buyers drop. Fix the packaging itself for fragile items.

## 4. Accuracy vs Listing (expectation gap)

- **Typical phrasings:** "not as pictured," "color is different," "smaller than expected," "photo is misleading," "description says X but it's Y," "false advertising."
- **Usually signals:** **COPY** (the product is fine; the page oversold or mis-showed it). Occasionally PRODUCT if you changed the item without updating the page.
- **Proactive copy change:** Make every claim literally true. Show true-to-life color photos under neutral light, add a scale object, list exact specs, and remove or qualify any superlative the product can't back. This is the highest-ROI category — accuracy edits cut returns fast and cost nothing but time.

## 5. Value / Price

- **Typical phrasings:** "overpriced," "not worth it," "same as the cheaper one," "expected more for the money," "you can get this for less elsewhere."
- **Usually signals:** **COPY** (value isn't communicated) or **PRODUCT/PRICING** (genuinely uncompetitive). Read the comparison: is it "bad product" or "fine product, wrong price perception"?
- **Proactive copy change:** Justify the price — show what's included, the materials/warranty/support that cheaper rivals lack, and cost-per-use framing. If reviewers keep naming a specific cheaper competitor, that's a positioning problem, not just a copy problem.

## 6. Usability

- **Typical phrasings:** "confusing to set up," "instructions useless," "couldn't pair it," "controls are unintuitive," "had to watch a YouTube video."
- **Usually signals:** **BOTH.** Genuine design friction is PRODUCT; a thin/poor manual is COPY/CONTENT.
- **Proactive copy change:** Add a clear quick-start in the A+ content, a setup video, and a short troubleshooting FAQ on the page ("auto-dim flickering? Update firmware via..."). For recurring confusion, fix the onboarding/UX in the product. Pre-empting setup questions in copy also cuts support tickets.

## 7. Customer Service

- **Typical phrasings:** "seller never replied," "wouldn't honor warranty," "rude support," "couldn't get a refund," "no response to my message."
- **Usually signals:** **PRODUCT/OPS** — this is a process failure, not a page problem.
- **Proactive copy change:** Copy can reduce the *need* for contact (clear warranty terms, returns policy, FAQ) and set response-time expectations ("we reply within 24h"). But the fix is operational: staff the inbox, define warranty handling, and follow up on negative reviews publicly.

## 8. Missing Features (feature requests)

- **Typical phrasings:** "wish it had," "if only it came with," "would be perfect if," "needs a [longer cord / carrying case / app]," "I bought a different one because it has X."
- **Usually signals:** **PRODUCT** (roadmap input). Cluster these separately from complaints — they're opportunities, not defects.
- **Proactive copy change:** If the feature already exists and buyers missed it, surface it in a bullet/photo (that's a COPY fix). If it doesn't exist, copy can't fix it — but high-frequency requests that overlap with a top pain point (e.g., "longer cable" + "cable too short") are your strongest roadmap signals. Offer the missing piece as an add-on/cross-sell where possible.

---

**Clustering tips:** merge synonyms into one category before counting ("runs small," "too tight," "size up" -> Sizing/Fit). Keep a one-line definition per category in your codebook. A single review can land in multiple categories — count each. Promote a cluster to a named theme only at >=3 independent mentions or >=2% of reviews.
