Skip to content

Account Orders

Overview

Section titled “Overview”

Displays the order history for the currently logged-in customer. Shows a list of past orders with details like order number, date, total, and status. Customers can view and track their previous purchases.

Requirements

Section titled “Requirements”
  • Parent block: Must be inside commerce-connect/account
  • BigCommerce data: Customer order history from BigCommerce

Configuration

Section titled “Configuration”

Attributes

Section titled “Attributes”
  • settingsId (string) - Settings configuration identifier
    • Default: ""

Block Support

Section titled “Block Support”
  • HTML editing: Not supported

Usage

Section titled “Usage”

Placement

Section titled “Placement”

This block must be placed inside the Account parent block. It’s typically part of the customer account dashboard page.

Common Patterns

Section titled “Common Patterns”

From the demo video script, the Orders block is one of several customer self-service blocks:

[Account Dashboard]
  Account Menu
  → Account Orders ← (Order history list)
    Order #12345 | May 15, 2026 | $125.00 | Shipped
    Order #12344 | April 22, 2026 | $89.50 | Delivered
    [View Order Details button]
  Account Details
  Account Addresses

Customers can:

  • View all their past orders in chronological order
  • See order status (Pending, Processing, Shipped, Delivered, etc.)
  • Click to view detailed order information
  • Track shipments (if tracking info is available)

Technical Details

Section titled “Technical Details”

CSS Classes

Section titled “CSS Classes”

The block includes editor-specific styling (index.css) for the block interface.

Data Source

Section titled “Data Source”

The Orders block communicates with BigCommerce’s Orders API to:

  • Retrieve complete order history for the authenticated customer
  • Fetch order status updates
  • Display order line items and totals
  • Show shipping and tracking information

All order data is managed in BigCommerce. When the block loads:

  1. Customer authentication is verified
  2. API request is made to BigCommerce for customer’s orders
  3. Orders are returned with full details (items, totals, status, dates)
  4. Orders are displayed in WordPress® UI with BigCommerce data

Order information is NOT stored in WordPress® - it’s pulled from BigCommerce in real-time to ensure accuracy.

Troubleshooting

Section titled “Troubleshooting”

Orders not displaying

Section titled “Orders not displaying”
  • Verify the customer is logged in
  • Check that the block is inside an Account parent block
  • Ensure the customer has placed orders in BigCommerce
  • Verify BigCommerce API connection is active

Order list is empty for customer with orders

Section titled “Order list is empty for customer with orders”
  • Check customer ID match between WordPress® session and BigCommerce
  • Verify API permissions include order data access
  • Review browser console for API errors
  • Test order retrieval in BigCommerce admin for that customer

Order details incomplete or missing

Section titled “Order details incomplete or missing”
  • Verify BigCommerce API is returning full order data
  • Check for API rate limiting or timeout issues
  • Ensure order data is complete in BigCommerce admin
  • Review network requests for partial responses

Order status not updating

Section titled “Order status not updating”
  • Order status is pulled from BigCommerce on page load
  • Customer may need to refresh the page to see status updates
  • Check that order status is updated in BigCommerce admin
  • Verify the status sync is not cached in WordPress® or CDN

Customer sees other customers’ orders

Section titled “Customer sees other customers’ orders”
  • CRITICAL SECURITY ISSUE - Report immediately
  • Verify authentication token is being validated correctly
  • Check that customer ID is properly scoped to authenticated user
  • Review API request parameters for customer filtering