Order Statuses
Defining order workflow stages and status labels for customer communication and internal tracking
Introduction
Order Statuses are the building blocks of your order management workflow. Each status represents a stage in the order lifecycle—from placement to fulfillment to completion. Well-defined order statuses help your team track progress, automate customer notifications, and provide transparency to customers about their order's journey.
Accessing Order Statuses Management
Order Status Interface Overview
Order Status Configuration Fields
Basic Configuration
Single Field Setup
Order Status Name: (Required) The label displayed in admin and customer communications (e.g., "Pending", "Processing", "Shipped", "Completed", "Cancelled")
Special Status Assignments
System Defaults
Default Order Status: One status can be assigned as the default for new orders (configured in store settings).
Complete Order Status: Typically used to trigger affiliate commissions and reward points.
Cancelled Order Status: Used to reverse inventory deductions and trigger refund workflows.
Multi-Language Support: Order status names can be translated for each language in your store. When editing an order status, you'll see language tabs where you can enter translations for each active language. Customer notifications will use the appropriate language version.
Common Tasks
Creating a Custom Order Workflow
To match your business processes:
Navigate to System → Localization → Order Statuses and click Add New.
Enter a clear Order Status Name that describes the workflow stage.
For multi-language stores, switch between language tabs to provide translations.
Click Save. The new status will be available when updating orders.
Setting Up Status-Based Automation
To trigger actions based on status changes:
Identify key status transitions (e.g., "Processing" → "Shipped").
Consider extensions that add advanced automation (stock updates, CRM integration, task assignments).
Test the workflow by placing a test order and updating its status.
Best Practices
Workflow Design Strategy
Process Optimization
Minimal Essential Statuses: Create only the statuses you actually use to avoid confusion.
Clear Progression: Design statuses that represent clear, sequential stages (e.g., Pending → Processing → Shipped → Delivered).
Team Alignment: Ensure all staff understand what each status means and what actions are required.
Customer Communication: Choose status names that are customer-friendly when shown in order history.
Technical Integration
System Coordination
Notification Mapping: Link each status to appropriate email templates.
Extension Compatibility: Verify that payment, shipping, and reporting extensions work with your statuses.
API Integration: If using external systems (ERP, CRM), ensure status names match between systems.
Historical Data: Never delete statuses used in historical orders—disable or hide them instead.
Deletion Warning ⚠️ Never delete an order status that is: 1) assigned as default order status, 2) assigned as default download status, or 3) used in existing orders. Check error messages carefully and reassign defaults before deletion.
Troubleshooting
Order status not updating customer notifications
Email Configuration Issues
Mail Settings: Verify email is properly configured in System → Settings → Mail.
Notification Triggers: Check that the status is configured to trigger notifications in store settings.
Email Templates: Ensure email templates exist for the status in your language directory.
Queue Processing: If using email queues, check if emails are stuck in the queue.
Cannot delete an order status
Dependency Issues
Default Assignment: The status may be set as default order status or default download status.
Order History: The status is used in existing orders (check error message for count).
Solution:
Change default assignments in store settings.
Create replacement status and update existing orders (may require database query).
Attempt deletion again.
Digital products not accessible after purchase
Download Status Configuration
Order Status Check: Ensure the order has reached the complete status.
Download Limits: Check if download limits or expiration dates are preventing access.
File Permissions: Verify digital files are correctly uploaded and accessible.
Status names inconsistent across languages
Translation Management
Missing Translations: Ensure all active languages have translations for each status.
Translation Consistency: Use the same terminology across all order-related communications.
Length Considerations: Long translations might break admin interface layouts.
Customer-Focused Language: Use customer-friendly terms in storefront translations.
"Order statuses are the pulse of your business—each transition tells a story of progress, each notification builds customer confidence, and each completed status represents a promise kept."
Last updated