Orders

The Orders page shows all customer orders placed through WhatsApp. You can view order details, track order statistics, update order status, and see the conversation context around each order.

📸

Screenshot: Orders page showing statistics cards at the top, filters section, and orders table with columns for Order ID, Customer, Date, Items, Amount, Status, and Actions

orders-page.png

1. Go to Commerce → Orders from the sidebar
2. Capture the full page showing the stats cards, filters, and orders table
Save to: static/img/screenshots/catalog/orders/orders-page.png

---

Statistics cards

At the top of the page, 7 statistics cards give you a quick overview of your orders:

Card	Description	Color
Total Orders	Total number of orders across all statuses	—
Pending	Orders waiting to be processed	Amber
Processing	Orders currently being handled	Blue
Completed	Orders that have been fulfilled	Green
Cancelled	Orders that were cancelled	Red
Total Revenue	Total amount from completed orders	Purple
Today	Number of orders placed today	Pink

📸

Screenshot: Statistics cards showing Total Orders, Pending, Processing, Completed, Cancelled, Total Revenue, and Today counts

stats-cards.png

1. Capture the statistics cards row at the top of the Orders page
Save to: static/img/screenshots/catalog/orders/stats-cards.png

Large numbers are automatically formatted for readability — for example, 1,500 shows as "1.5K", 2,000,000 shows as "2M".

---

Filtering orders

Below the statistics cards, you'll find filters to narrow down the order list:

Filter	Description
Search	Search by order ID, customer name, or phone number
Status	Filter by: All, Pending, Processing, Completed, or Cancelled
Start Date	Show orders from this date onward
End Date	Show orders up to this date
Clear Filters	Reset all filters

📸

Screenshot: Filters section showing search field, status dropdown, date pickers, and clear button

filters-section.png

1. On the Orders page, capture the filters section with the search field, status dropdown, date range pickers, and Clear Filters button
Save to: static/img/screenshots/catalog/orders/filters-section.png

---

Orders table

The main section of the page is the orders table:

Column	Description
Order ID	A short 8-character identifier for the order
Customer	Customer name (bold) and phone number
Order Date	When the order was placed
Items	Number of items in the order
Amount	Total order amount with currency
Status	Color-coded status chip
Actions	View Details button

📸

Screenshot: Orders table showing rows with order ID, customer info, date, items count, amount, status chips, and view details action

orders-table.png

1. Capture the orders table showing several rows with different statuses (pending, processing, completed)
Save to: static/img/screenshots/catalog/orders/orders-table.png

Order statuses

Status	Color	Description
Pending	Amber/Yellow	Order has been received but not yet processed
Processing	Blue	Order is being prepared or handled
Completed	Green	Order has been fulfilled and delivered
Cancelled	Red	Order was cancelled

Pagination

At the bottom of the table, pagination controls let you navigate through large order lists:

• Page size options: 10, 20, 50, or 100 orders per page
• Navigation: First page, previous, next, and last page buttons

---

Order details

Click the View Details button (or click anywhere on an order row) to open the detailed order view.

📸

Screenshot: Order Details dialog showing order header with status, customer information, order items table, status management, and conversation context

order-details-dialog.png

1. Click View Details on any order
2. Capture the full dialog showing the left panel (order info) and right panel (conversation context)
Save to: static/img/screenshots/catalog/orders/order-details-dialog.png

The Order Details dialog has two panels:

Left panel — Order information

This panel contains all the order details, organized into sections:

Order header

Shows the order ID and current status chip at the top, along with the order date and time.

Customer information

Field	Description
Name	Customer's name
Phone	Customer's phone number

Order items

A table showing each product in the order:

Column	Description
Product	Product image (or placeholder), name, and retailer ID
Qty	Quantity ordered
Price	Unit price
Subtotal	Quantity × Price

Below the items table, the Total row shows the combined order amount.

If the customer included a message with their order (order notes), it appears in a highlighted box below the items.

📸

Screenshot: Order items section showing product images, names, quantities, prices, subtotals, and the total row

order-items-table.png

1. In the Order Details dialog, capture the order items table showing product details and the total
Save to: static/img/screenshots/catalog/orders/order-items-table.png

Manage order status

This section lets you change the order status:

1. Select a new status from the dropdown (Pending, Processing, Completed, or Cancelled)
2. Click Update Status

📸

Screenshot: Manage Order Status section showing status dropdown, Update Status button, and status timeline

manage-status.png

1. In the Order Details dialog, scroll to the Manage Order Status section
2. Capture the status dropdown, Update Status button, and the status timeline below
Save to: static/img/screenshots/catalog/orders/manage-status.png

Below the status controls, a status timeline shows the history of status changes:

Event	Timestamp
Ordered	When the order was placed
Processing	When the order was moved to processing (if applicable)
Completed	When the order was marked as completed (if applicable)
Cancelled	When the order was cancelled (if applicable)

Each event shows the date and time when the status change occurred.

Right panel — Conversation context

The right side of the dialog shows the WhatsApp conversation around the order, giving you context about what the customer said before and after placing the order.

📸

Screenshot: Conversation context panel showing chat messages and the highlighted order message with cart details

conversation-context.png

1. In the Order Details dialog, capture the right panel showing chat messages and the highlighted order message
Save to: static/img/screenshots/catalog/orders/conversation-context.png

Element	Description
Customer messages	Shown on the left side of the chat
Your messages	Shown on the right side of the chat
Order message	Highlighted in green with a shopping cart icon, showing "ORDER RECEIVED", item count, total amount, and item breakdown
Full Chat button	Opens the full conversation in the Chat module

The conversation context shows messages from approximately 1 hour before and after the order, giving you a window into the customer's intent and any follow-up messages.

tip

Click the Full Chat button in the top-right corner of the conversation panel to open the complete conversation with the customer in the Chat module.

---

Updating order status

You can update an order's status from the Order Details dialog:

1. Open the order details (click on the order row or the View Details button)
2. In the Manage Order Status section, select the new status
3. Click Update Status

Status workflow

Orders typically follow this flow:

Pending → Processing → Completed
                  └──→ Cancelled

Transition	When to use
Pending → Processing	When you start handling the order (packing, preparing)
Processing → Completed	When the order has been fulfilled and delivered
Pending → Cancelled	When the order is cancelled before processing
Processing → Cancelled	When the order is cancelled during processing

When you update the status, the system records the timestamp of the change. This is reflected in the status timeline.

---

Automating order management

You can automate responses to new orders using Chatbot Flows with the Order Received trigger.

Example automation:

1. Customer places an order on WhatsApp
2. The Order Received trigger fires automatically
3. Your chatbot flow sends an instant confirmation: "Thanks for your order! Order #{{order.catalog_id}} — {{order.product_items.0.quantity}} items totaling {{order.product_items.0.item_price}}"
4. A Condition node checks the order total
5. High-value orders are routed to a human agent; smaller orders get an automated confirmation

See Trigger Blocks — Order Received for the full list of order variables available in chatbot flows.

---

Tips

• Check the Orders page regularly to process pending orders promptly
• Use the date range filters to generate reports for specific periods
• The Total Revenue card only counts completed orders — use this as your actual sales figure
• Enable the Order Received chatbot trigger to send instant order confirmations
• Use the conversation context to understand what the customer discussed before ordering — this helps with personalized follow-ups