Items

The Items tab is where admins maintain the product lines attached to an order. Open any order in yStore → Orders, then select the Items tab to reach this view.

What the Items tab shows

Each row in the item list displays:

• Product name and SKU
• Quantity ordered
• Unit weight
• Unit price and line total (tax-inclusive or tax-exclusive depending on your display settings)

Adding a new item to an existing order

Admins can add products to an order after it has been placed — this is the admin cart functionality.

1. Open the order and click Edit in the Items area (or use the global Edit action at the top of the order).
2. In the Items section, search for and select the product you want to add.
3. Set the quantity.
4. Click Save.

yStore appends the new line item, copies quote items back to the order, and recalculates all totals automatically. The Summary panel reflects the updated numbers immediately.

Editing item quantity and price

1. Click the Edit icon (or open the item slideout) next to the line you want to change.
2. Update the quantity or enter a price override to set a custom unit price for this order line.
3. Save the slideout.

After saving, the plugin recalculates both the order item record and the linked quote item so totals stay consistent.

Removing an item

1. In the Items list, click the Remove action next to the line item.
2. Confirm the removal in the dialog.

The product is removed from both quote context and order context, and totals are recalculated.

Locked orders

warning

When an admin manually adjusts totals in the Summary tab, the order becomes locked (is_locked = true). In locked mode, item editing controls are hidden or restricted. This protects the manually set totals from being overwritten by automatic recalculation.

If you need to edit items on a locked order, you must first unlock it via the Summary tab. Be aware that unlocking and saving will trigger a full recalculation, which may replace your manual total adjustments.

Tax display in item rows

Item rows can show:

• Excl. tax values
• Incl. tax values
• Or both

Display behaviour follows the sales tax display configuration set for order items in yStore → Settings → Sales.

Exporting items

Admins can export the line items for any order using the order export action. Supported formats:

Format	Use case
csv	Spreadsheet analysis and bulk imports
json	Custom integrations and developer workflows
xlsx	Accounting and fulfilment reconciliation

The export includes SKU, quantity, pricing, tax, and line total columns.