nohold / docs

Welcome

What nohold does and how to get oriented in these docs.

nohold sits between Shopify and Brightpearl. When a customer buys an in‑stock item and a pre‑order in the same cart, nohold splits the order into two clean Sales Orders before Brightpearl ever receives it. Your in‑stock SO ships today; the pre‑order SO sits on hold until inventory lands, then auto‑releases.

No more frozen mixed-cart orders. No manual splitting. No retraining your warehouse team.

What you'll find in these docs

  • Get started. Install the Shopify app, connect Brightpearl, and confirm your first split.
  • How splitting works. Detection rules, tax/shipping/discount math, customer notifications, ETAs, the FTC delay-and-cancel flow, hold release rules, multi-location handling, refund reconciliation, and failure handling.
  • Settings reference. Every field on the Settings page, what it does, and what to set it to.
  • Analytics. The preorder demand panel, per-campaign breakdown, and CSV export.
  • Operations. The reconciliation health card and the background sweeper that keeps things moving.
  • Internals. The technical view, written for evaluators: webhook surface, data model, API contracts, idempotency guarantees.
  • Troubleshooting. Order didn't split? SO didn't release? Brightpearl outage? Start here.
  • Billing & quotas. Plans, what counts as a split, and what doesn't.
  • Changelog. Notable updates, reverse-chronological.

Who these docs are for

Operations and finance teams running Shopify and Brightpearl. You don't need to know anything about webhooks, queues, or APIs; that's nohold's job.

If you're evaluating nohold for correctness or doing a security review, the Internals section covers the public technical view. Source-level detail lives in our private repo. Email hello@nohold.app for an NDA'd call.

Status

nohold is in pre-launch. Onboarding is invite-based via the waitlist. If you're already in the beta, you have everything you need to install. These docs cover the rest.

On this page