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 live on the Shopify App Store. Install from there, connect your Brightpearl account, and you're off. These docs cover the rest.

On this page