The Orders tab in Site Settings defines global ecommerce order behavior. These settings control how invoice numbers are generated, how customer‑facing order IDs are created, when stock is subtracted, when downloads become available, and whether guest checkout is allowed.

These configurations apply to all orders placed on the site unless overridden by plugins or custom logic.

1. Invoice Format

Invoice Format Pattern

  • Field: Invoice Format
  • Example:
    I-{year2}-{month}-{order_id}-{user_id}-{customer_order_id}
  • Preview:
    I-26-03-777-1000-OI888

Description

Defines the format of generated invoice numbers.
You can use dynamic placeholders:

Placeholder Meaning
{year} Full year (e.g., 2026)
{year2} Last two digits of year (e.g., 26)
{month} Month number (e.g., 03)
{day} Day of month
{order_id} Internal order ID
{customer_order_id} Public customer‑facing order ID
{user_id} Customer ID
{rand-str-#} Random alphanumeric string of length #

This allows full customization of invoice numbering for accounting or legal requirements.

2. Customer Order ID Format

Customer Order ID Pattern

  • Field: Customer Order Id

  • Description:
    Generates a unique, non‑sequential order ID for customers.
    Helps prevent exposing total order count and improves privacy.

  • Example Pattern:
    {rand-str-12}-{year2}

  • Preview:
    JXDILECEQRPI-26

Usage

This ID is shown to customers in:

  • Order confirmation pages
  • Emails
  • Account order history
  • Guest order lookup

It is not the internal order ID used by the system.

3. Cart & Checkout Behavior

Display Weight on Cart Page

  • Field: Display weight on cart page
  • Type: Toggle
  • Description:
    Shows total cart weight to customers.
    Useful for stores where shipping cost depends on weight.

Allow Guest Checkout

  • Field: Allow guest checkout
  • Type: Toggle
  • Description:
    Allows customers to place orders without creating an account.
    When disabled, checkout requires login or registration.

4. Order Status Configuration

These settings define how the system behaves when an order reaches certain statuses.

New Order Status

  • Field: New Order Status
  • Example: Pending
  • Description:
    The status assigned to an order immediately after it is placed.

Subtract Stock on Order Status

  • Field: Subtract stock on order status
  • Example: Pending
  • Description:
    Determines when product stock is reduced.
    Also controls when:
    • Coupons
    • Vouchers
    • Reward points
      are redeemed.

Tip:
Many stores subtract stock on Pending, but stores requiring payment confirmation may choose Processing or Paid.

Enable User Downloads on Order Status

  • Field: Enable user downloads on order status
  • Example: Pending
  • Description:
    Defines when customers can access:
    • Digital downloads
    • Gift vouchers
    • License files

For paid digital products, this is often set to Paid or Completed.

Summary

The Orders Tab configures:

  • Invoice number formatting
  • Customer‑facing order ID generation
  • Guest checkout availability
  • When stock is subtracted
  • When downloads become available
  • Default order status on creation

These settings ensure consistent order processing, proper stock management, and a smooth checkout experience.