Skip to content

Collection arrival page

The page a customer collecting an order reaches from their "ready to collect" email, /collect/{token} (Nova's templates/nova/collect/arrival.html, used by every Nova-family theme; no theme overrides it). It tells the shop the customer is on the way or outside, and, since November 2026, tells the customer when someone from the shop is bringing their order out. The lifecycle behind it is in Collecting an order.

What was decided

  • The page, not a message, tells the customer someone is coming. Badger has no SMS channel, and an email is the wrong tool for someone sitting in a car park. The customer already has the page open (they used it to say they're here), so the page updates itself.
  • It says that someone is coming, never who. The signed link is the only key and can be forwarded, so the page shows Someone from the shop is on their way out to you with your order. and the member of staff's optional message, and nothing that names staff. Staff see who has it in the POS app.
  • The message is plain text. Staff type it on a till (at most 140 characters); the page renders it with th:text and the poll sets it with textContent, so markup in it shows as typed. It sits under a label, Their message:, so it reads as the shop speaking.
  • A light poll, only while it can matter. Inline script in the template checks GET /collect/{token}/status every 15 seconds, only once the customer has said they're coming or here, only while the order is ready, and not while the tab is hidden (it checks again as soon as the tab is visible). It gives up after two hours. When the order is collected or cancelled, or the link stops working, it reloads the page once, which then says what happened and has no script. The endpoint lives on the same storefront controller as the page's two forms, under the same token, rather than in the REST API: the page is server-rendered and posts forms to that controller already.
  • The notice is in the page from the start, hidden while nobody has the order, so the script only toggles hidden and fills the message; every word comes from message keys (collect.arrival.staffComing, collect.arrival.staffMessage) rendered by the template. The script writes no text of its own.
  • Same look as the page's other notices: the confirmation notice style (nova-arrival__notice--ok), role="status" with aria-live="polite" so a screen reader announces it when it appears.

Rules a later change must keep

  • Nothing on the page or in the status answer may identify a member of staff, the customer's vehicle or the order's items. The answer is {state, arrivalState, staffComing, staffMessage}.
  • The status answer, like the page, is Cache-Control: private, no-store and Referrer-Policy: no-referrer.
  • No polling before the customer has said they're coming, or after the order is collected or cancelled.