Skip to content

docs: Prevent Overselling setting + variation stock visibility - #340

Draft
kilbot wants to merge 1 commit into
mainfrom
docs/prevent-overselling
Draft

docs: Prevent Overselling setting + variation stock visibility#340
kilbot wants to merge 1 commit into
mainfrom
docs/prevent-overselling

Conversation

@kilbot

@kilbot kilbot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

Closes #87. Part of the Prevent overselling epic (wcpos/roadmap#1), planned via the wayfinder map (wcpos/roadmap#48).

Status: content complete — HOLD for the v1.10 release train

The feature is merged on next in wcpos/woocommerce-pos (#1259) and wcpos/monorepo (#719, #721, #723, #724) but has not shipped to stable yet. Draft until the nextmain release train ships so the docs don't describe a feature users can't see. Content needs no further work.

What's documented

Checkout Settings page — new Prevent Overselling section:

  • What the toggle does (till-side blocking + server-side checkout validation), default off
  • The stock-decision table (managed / variation-level / parent-shared / unmanaged)
  • Backorder precedence (allow/notify always sellable — the per-product overselling escape hatch)
  • The distinction from the Show out of stock display setting
  • Freshness note (open sessions pick the toggle up at next login; server side applies immediately)

Variations page — the popover stock badge, greyed-out exhausted options, out-of-stock rows excluded from inline expand, and the barcode out-of-stock refusal (all governed by the display setting).

Validation

  • pnpm test: 191/191 pass
  • No i18n/** files touched (translation pipeline handles locales per repo policy)

Note: pushed over HTTPS — SSH transport to GitHub was hanging from this machine today.

New 'Prevent Overselling' section on the Checkout Settings page: what
the toggle does at the till and server-side, the stock-decision table,
backorder precedence, the distinction from the 'show out of stock'
display setting, and when a toggle change reaches open sessions. The
Variations page gains the popover stock badge, greyed-out exhausted
options, filtered expanded rows, and the barcode out-of-stock refusal.
@vercel

vercel Bot commented Jul 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jul 18, 2026 6:14pm

Request Review

@coderabbitai

coderabbitai Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one) (1)
  • needs-ai-review

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 0670a464-e2df-4eff-a103-5e9721865cb2

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document overselling prevention setting

1 participant