What Shopify access does OrderBrief Atlas request?
OrderBrief Atlas currently requests the minimum order-read scope required for its workflow: read_orders.
Support
Frequently Asked Questions
Common questions about installation, order-note processing, billing, logs, and what merchants should expect from OrderBrief Atlas in daily fulfillment workflows.
What order data does the app read?
OrderBrief Atlas reads the merchant-authored order note, order name, order ID, tags, and custom attributes that help fulfillment teams understand special handling requests.
How are summaries generated?
The app applies a rules-based note parser to detect urgent, gift, date-sensitive, customization, and warning signals. It then generates a short internal brief, action text, and risk score for staff review.
Does OrderBrief Atlas modify Shopify order tags or metafields?
No. Summary results and checklist state are stored inside OrderBrief Atlas only. The app does not write its brief output back into Shopify orders, tags, or metafields.
What happens when I mark a checklist item?
Checklist state is saved in OrderBrief Atlas and stays synchronized across the dashboard and supported Shopify Admin extension surfaces for the same order.
Where can I see webhook processing activity?
The Webhook Logs tab shows inbound Shopify events, processing status, and paged history so operators can inspect event flow without reading raw server logs.
What does Processing Rules change?
Processing Rules lets merchants add shop-specific urgent, gift, date-sensitive, customization, and warning keywords. Those rules change how future briefs are classified, and the retention setting controls how long saved briefs and webhook logs stay in the app database.
Are manual reprocess and checklist actions available on every plan?
No. Manual reprocess and checklist actions are limited by plan. Starter stores can review summaries, while paid plans unlock the manual workflow actions documented in the billing surface.
What if protected customer data approval is still pending?
If Shopify has not yet approved the required protected customer data access, OrderBrief Atlas does not fail with a raw server error. Instead, order-level actions return a guidance message so merchants know the workflow is blocked by platform approval rather than store data loss.