Add the title of the order status.

 Add "Slug," which is the URL

Pick an icon by selecting "Add Icon."

A new window will come up with the icons you can select.

Select the color of the icon.

Is a paid status option

If you check this option, it will include download links, purchase notes, or other features when customers view these orders. Think of it as being between processing and complete.

Add to actions on the orders page

Add to bulk actions list.

Enable Email Notification

This will allow an email notification to go when the status is changed. You must have this checked for the notifications to work. You can select an internal notification for admins or the status you want the customer to receive. If you want both the admin and customer to get email notifications then you need to select "Customer" as Email Recipient and add the admin email as an email copy.

Note: Edit Order Status

To edit order status. You would click on the "Custom Order Status" tab. Here you will have the list of the customer order status, which you can click on to edit.

• Add a recognizable icon to your custom status.
• Set Color and Text Background Color for a readable badge.
• Choose how it appears in lists with Status View (Name or Icon).
• Preview the result in WooCommerce → Orders.

Open the status editor

Path: WooCommerce → Orders → Order Status → Edit (pick a status) or Add New (create one).

ALT: Status editor opened from WooCommerce → Orders → Order Status.
Caption: “Open the status editor from Orders → Order Status.”

Add an icon

Click Add Icon and pick a simple, descriptive icon. Avoid overly detailed shapes; prefer clear silhouettes.

ALT: Icon picker open for the custom status.
Caption: “Choose a simple, easy-to-recognize icon.”

ALT: Selected icon applied to the status.
Caption: “Confirm the icon is assigned.”

Choose badge colors

Use Color (text/icon) and Text Background Color (badge background) to ensure contrast and quick scanning.

ALT: Open color pickers for text/icon and badge background.
Caption: “Set text/icon color and the badge background.”

Contrast tips

• Dark text on a light background or light text on a dark background.
• Avoid low-contrast pairs (e.g., mid-gray on light gray).
• Keep a consistent palette across your statuses.

ALT: Comparison of high-contrast vs. low-contrast status badges.
Caption: “Prefer high-contrast combinations for readability.”

Status View: Name vs Icon

Control how the status renders in the orders table.

• Name: shows the text label (clearest for all users).
• Icon: replaces text with the icon (works if your team recognizes the symbols).

ALT: Status View dropdown open with Name and Icon options.
Caption: “Choose whether to show the name or only the icon.”

Preview in Orders

Save the status and open WooCommerce → Orders to validate readability at a glance.

• Check the badge in the Status column.
• If using Icon view, make sure the icon is self-explanatory.

ALT: Orders view showing badges rendered as Name and as Icon.
Caption: “Verify readability and consistency in the orders list.”

Best practices

• Reuse 2–4 core colors to group stages (e.g., blues = in progress, greens = completed, reds = blocked).
• Reserve red/yellow for alerts or states that require attention.
• Don’t rely on color alone: the text or icon must be clear.

Troubleshooting

• Badge looks pale/hard to read: increase contrast (text vs background).
• Icon is confusing: switch to a simpler symbol or use Status View = Name.
• No changes in Orders: save the status and refresh; clear cache if you use a caching plugin.

• Enable Paid Status to treat an order with this status as paid.
• Enable Download Access to allow customers to download digital files when this status is applied.
• Use these only if they match your store’s business logic.

Open the status editor

Go to WooCommerce → Orders → Order Status → Edit (choose a status) or Add New (create one). Scroll to the advanced options section.

ALT: Status editor showing Paid Status and Download Access toggles.
Caption: “Advanced options for treating a status as paid or granting downloads.”

Paid Status

When this toggle is ON, WooCommerce will treat the order as paid when moved into this status.

• Use it for statuses that come after payment (e.g., Awaiting Shipment).
• Avoid enabling it on pre-payment stages (e.g., Pending Deposit).

ALT: Toggle ON for Paid Status.
Caption: “Enable Paid Status if this stage confirms payment.”

Effects of enabling Paid Status

• Marks the order as paid in WooCommerce logic.
• Stock is reduced for the items if not already reduced.
• Status can appear in reports as part of completed sales (if reporting is enabled).

Download Access

When this toggle is ON, customers gain access to digital downloads linked to their order once it enters this status.

• Useful for statuses like Ready for Download or Delivered.
• Do not enable if the order should not yet grant access (e.g., Awaiting Review).

ALT: Toggle ON for Download Access.
Caption: “Grant customers download rights when this status is applied.”

Effects of enabling Download Access

• Customer receives permission to download files tied to the order.
• If combined with Paid Status, it fully mimics WooCommerce’s Completed behavior.
• Can trigger download email notifications if configured.

Best practices

• Only enable Paid Status for workflow stages where payment is confirmed.
• Use Download Access for digital stores to control exactly when downloads unlock.
• If both are ON, the status behaves almost like Completed but retains your custom label.
• Test with a dummy order before rolling out to production to avoid giving early access.

Troubleshooting

• Download links not appearing: ensure Download Access is ON and the order contains digital products.
• Stock not reduced: verify that Paid Status is ON and WooCommerce stock management is active.
• Reports not updating: check if the status is also set to Display in Reports (another option in the editor).

• Enable your custom status in single-order actions (order page dropdown).
• Enable it in bulk actions (Orders list dropdown).
• This ensures your team can apply the status quickly, one order at a time or in bulk.

Open the status editor

Go to WooCommerce → Orders → Order Status → Edit (pick a status) or Add New (create one). Scroll down to the action toggles.

ALT: Custom status editor showing the toggles for actions and bulk actions.
Caption: “Enable your status in single-order and bulk menus.”

Add to actions on orders page

When enabled, the status appears in the Actions menu of each order.

• Useful for quickly updating one order without opening it fully.
• Status is added to the order action dropdown alongside native WooCommerce actions.

ALT: Orders table with a custom status visible in the Actions dropdown.
Caption: “Apply the custom status from the order’s action menu.”

Add to bulk actions list

When enabled, the status appears in the Bulk actions dropdown on the Orders list.

• Ideal for processing multiple orders at once.
• Select several orders → Bulk actions → Apply your custom status.

ALT: Orders list with custom status added to the bulk actions dropdown.
Caption: “Update multiple orders at once using Bulk actions.”

Best practices

• Only enable actions that your team needs frequently to avoid clutter.
• Keep the names short so they fit cleanly in dropdown menus.
• Test on staging to confirm the custom status triggers correctly when applied in bulk.

Troubleshooting

• Status not appearing: make sure the toggle is ON and the status is saved.
• Bulk action applies but nothing changes: refresh the Orders page and confirm the status is active.
• Too many options in dropdown: disable unneeded statuses to simplify the menu.

• Configure Increase stock or Decrease stock per custom status from the plugin Stock / Inventory settings.
• On status change, stock is automatically adjusted by the order item quantities.
• Changes sync immediately with WooCommerce product inventory.

Is this available in the Free version?
No. “Stock Increase” and “Stock Decrease” per status are available only in the PRO version.

Open the Stock / Inventory settings

Go to Bright Plugins → Order Status Settings → Stock / Inventory. You’ll see a list of all custom order statuses with two checkboxes for each: Increase stock and Decrease stock.

ALT: Stock / Inventory settings listing statuses with Increase stock and Decrease stock checkboxes.
Caption: “Set per-status stock behavior from a single place.”

Configure per-status behavior

• Increase stock: moving an order into this status adds item quantities back to stock.
• Decrease stock: moving an order into this status deducts item quantities from stock.
• Neither selected: no stock change when the order moves to this status.

ALT: Example rows with Increase ON, Decrease ON, and neither selected.
Caption: “Increase, decrease, or do nothing per status.”

Save & persistence

Click Save to store your selections. Choices are persisted and applied on future status changes.

ALT: Save button to persist per-status stock options.
Caption: “Save to persist your selections.”

What happens on status change

• If Increase stock is enabled for the destination status, stock is incremented by each order item’s quantity.
• If Decrease stock is enabled, stock is decremented accordingly.
• Adjustments reflect immediately in WooCommerce product inventory views.

ALT: Order moved to a status with Increase stock; product stock reflects the increment.
Caption: “Stock updates as soon as the status changes.”

Best practices

• Avoid enabling both checkboxes for the same status.
• Use Decrease for reserving inventory early (e.g., Reserved, Packing).
• Use Increase for cancellations/returns (e.g., Cancelled, Returned).
• Test with a dummy product before production.

Troubleshooting

• No stock change: ensure the status has the correct checkbox set, the order has stock-managed items, and you clicked Save.
• Double deduction: review other automations or native WooCommerce events to avoid overlapping decreases.
• Wrong direction: verify you toggled the intended checkbox (Increase vs Decrease).

• Control reporting per status with a single checkbox: Display in Reports.
• When enabled, orders in that status contribute to dashboards/metrics.
• When disabled, they are excluded from totals and statistics.

Is this available in the Free version?
No. “Display in reports” is available only in the PRO version.

Open the reporting control

Edit the custom status options and locate the Display in Reports checkbox.
Remember to Save after changing this option.

ALT: Custom status editor showing the Display in Reports checkbox.
Caption: “Include or exclude this status from reports.”

Include or exclude a status

• Enabled: orders with this status appear in reports, affecting counts/metrics.
• Disabled: they’re ignored by reports.

ALT: Display in Reports checkbox toggled OFF vs ON.
Caption: “Toggle whether this status affects metrics.”

Verify in Analytics/Reports

After saving the status, open your reports to confirm inclusion/exclusion.

• Use status filters to show the custom status.
• Confirm order counts (and revenue if your setup treats that status as paid).
• Compare before/after toggling the checkbox.

ALT: Reports view with the custom status filter selected.
Caption: “Filter by your custom status to validate.”

Best practices

• Enable for final, customer-visible stages you want reflected in KPIs.
• Keep internal transitions out to avoid inflating totals.
• If your analytics treats that status as paid, make sure that reflects your real process.

Troubleshooting

• Status not in filters: save the status, refresh reports, and ensure analytics cache is cleared.
• Totals look off: check whether the status should be included; toggle Display in Reports accordingly.
• No change after enabling: verify date range, selected filters, and that you have orders in that status.