> ## Documentation Index
> Fetch the complete documentation index at: https://help.mockspark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Order-Items

> Manage your customizable product orders more efficiently

export const ColorText = ({color, text}) => {
  return <span style={{
    color: color,
    fontWeight: 800,
    fontSize: 24
  }}>{text}</span>;
};

## What is a Order-Item?

When a customer places a customized product order through your store and completes payment, the order is automatically synced with MockSpark. Once we receive the order details, we break it down by product into smaller sub-orders, which we refer to as **Order-Items**.

<Tip>**The relationship between orders and order items**: From a customer perspective, an order is a list of selected products. For example, an order might contain two cups and a hat. Each product on that list is an order item. From a store perspective, an order is a list of order items. It is part of the store's data.</Tip>

Breaking down a single order into multiple **Order-Items** offers several key benefits:

1. A single order may include both customizable products fulfilled by MockSpark and other unrelated products sold in your store. Since we don’t handle those unrelated items, automatically filtering them out helps simplify order management and reduce confusion for you.
2. If a customer places one order for a T-shirt and later places another order for a hat, and both items are fulfilled through the same platform (such as Printify), we can now consolidate these Order Items based on the shipping address before sending them to the fulfillment provider. This significantly reduces shipping costs by avoiding duplicate shipment fees for items going to the same customer.
3. If an order contains an item that is out of stock or has another issue, we can easily move forward with fulfilling the available items without requiring you to manually split the order. This helps ensure faster fulfillment and reduces the risk of losing the entire order.

Go to the **Order Items** section from the top navigation bar.

<Frame>
  <img src="https://mintcdn.com/mockspark/4DeP8kx9tdJD6T-P/images/order-items/order-items/PixPin_2025-05-27_16-24-58.png?fit=max&auto=format&n=4DeP8kx9tdJD6T-P&q=85&s=dc73dde3dafe403779998090f33b4903" width="1180" height="660" data-path="images/order-items/order-items/PixPin_2025-05-27_16-24-58.png" />
</Frame>

## Search

The search area in the **Order Items** section supports the following six filter options:

1. `Shopify Order Name`: Unique identifier for the order that appears on the Shopify order. For example, #1000 or \_Store1001.
2. `Order Create At`: The date and time when the Order-Item was created. You can filter by a date range, with support for searching up to the most recent 90 days
3. `Product Title`: The product title with the Order-Item. Supports partial keyword search.
4. `Customer Email`: The customer's email address associated with the Order-Item.
5. `Fulfillment Platform`: The fulfillment platform responsible for processing the product in the Order-Item.
6. `Status`: The status of the Order-Item. To learn more, see our [Status of Order-Item Explained](/docs/order-items/order-items#status-of-order-item-explained)

You can apply multiple filters at once to refine your search. Click the **Search** button to view Order-Items that match your selected criteria.

<Frame>
  <img src="https://mintcdn.com/mockspark/4DeP8kx9tdJD6T-P/images/order-items/order-items/PixPin_2025-05-27_16-27-00.png?fit=max&auto=format&n=4DeP8kx9tdJD6T-P&q=85&s=c60baac055b7ba0b05c101c945588edc" width="1179" height="641" data-path="images/order-items/order-items/PixPin_2025-05-27_16-27-00.png" />
</Frame>

## Actions for a Single Order-Item

Each row in the list represents a single Order-Item. Click on a row to view the detailed page for that specific Order-Item.

<Frame>
  <img src="https://mintcdn.com/mockspark/4DeP8kx9tdJD6T-P/images/order-items/order-items/PixPin_2025-05-27_16-32-42.png?fit=max&auto=format&n=4DeP8kx9tdJD6T-P&q=85&s=6f0bf043954b3dec74aef42ac60c9a8e" width="1200" height="590" data-path="images/order-items/order-items/PixPin_2025-05-27_16-32-42.png" />
</Frame>

At the top of the Order-Item detail page, you can view key information about the Order-Item, including its creation date, status, and more.

<Frame>
  <img src="https://mintcdn.com/mockspark/4DeP8kx9tdJD6T-P/images/order-items/order-items/PixPin_2025-05-27_16-53-58.png?fit=max&auto=format&n=4DeP8kx9tdJD6T-P&q=85&s=5863beb0c27b5c0a1240352eaafd568d" width="1200" height="954" data-path="images/order-items/order-items/PixPin_2025-05-27_16-53-58.png" />
</Frame>

In the `Store` section of the detail page, you can view various details about this Order-Item as it appears on the sales platform, such as Shopify.

<Frame>
  <img src="https://mintcdn.com/mockspark/4DeP8kx9tdJD6T-P/images/order-items/order-items/PixPin_2025-05-27_16-54-47.png?fit=max&auto=format&n=4DeP8kx9tdJD6T-P&q=85&s=5fada2bc91b85d67e8923aef5f39ceaa" width="1200" height="954" data-path="images/order-items/order-items/PixPin_2025-05-27_16-54-47.png" />
</Frame>

On the left side of the `Store` section, you’ll find information such as **Notes**, **Customer**, and **Shipping Method** for this Order-Item.

If the customer updates details such as Notes or Customer information on the sales platform (for example, Shopify) after placing the order, you can click the **Sync** button to update the Order-Item accordingly.

<Frame>
  <img src="https://mintcdn.com/mockspark/4DeP8kx9tdJD6T-P/images/order-items/order-items/PixPin_2025-05-27_16-56-53.png?fit=max&auto=format&n=4DeP8kx9tdJD6T-P&q=85&s=4e8401d7ea052132d3324a114f0bb755" width="1200" height="954" data-path="images/order-items/order-items/PixPin_2025-05-27_16-56-53.png" />
</Frame>

You can also adjust the design of this Order-Item by clicking the **Redesign** button and making changes in the `Product Personalizer`.

<Frame>
  <img src="https://mintcdn.com/mockspark/4DeP8kx9tdJD6T-P/images/order-items/order-items/PixPin_2025-05-27_16-58-53.png?fit=max&auto=format&n=4DeP8kx9tdJD6T-P&q=85&s=44e66621651b3f84006d89f6ad721a0d" width="1200" height="954" data-path="images/order-items/order-items/PixPin_2025-05-27_16-58-53.png" />
</Frame>

In the `Product Personalizer`, you can not only edit the design of the Order-Item but also change the associated **variant**, such as the product size or style.

Click **Save Design** to save your changes.

<Frame>
  <img src="https://mintcdn.com/mockspark/4DeP8kx9tdJD6T-P/images/order-items/order-items/PixPin_2025-05-27_17-00-24.png?fit=max&auto=format&n=4DeP8kx9tdJD6T-P&q=85&s=ad4a3913099661a06e9a4ec22853aef0" width="1198" height="951" data-path="images/order-items/order-items/PixPin_2025-05-27_17-00-24.png" />
</Frame>

Steps to fulfill this Order-Item:

1. Click the **Send to Fulfill** button at the top of the Order-Item detail page.
2. In the dialog box, enter the required information for fulfilling this Order-Item. The form fields may vary depending on the fulfillment platform you are using.
3. Click the **Send to Fulfill** button in the dialog box to submit this Order-Item to the assigned fulfillment platform.

<Frame>
  <img src="https://mintcdn.com/mockspark/4DeP8kx9tdJD6T-P/images/order-items/order-items/PixPin_2025-05-27_17-02-14.png?fit=max&auto=format&n=4DeP8kx9tdJD6T-P&q=85&s=6d5226c5890b0bad00ea8d11ad5a622e" width="1200" height="954" data-path="images/order-items/order-items/PixPin_2025-05-27_17-02-14.png" />
</Frame>

Click **Move actions** to open a dropdown menu with additional available options:

1. `Export CSV`: Export the data for this Order-Item as a CSV file.
2. `Download production files`: Download the production files for this Order-Item as a ZIP file.
3. `Manually mark as fulfilled`: Manually mark this Order-Item as `Fulfilled`.
4. `Cancel order`: Manually mark this Order-Item as `Canceled`.
5. `Archive`: Manually mark this Order-Item as `Archived`.

<Frame>
  <img src="https://mintcdn.com/mockspark/4DeP8kx9tdJD6T-P/images/order-items/order-items/PixPin_2025-05-27_17-03-23.png?fit=max&auto=format&n=4DeP8kx9tdJD6T-P&q=85&s=c2f48a718df973a617c767fc01bb1c8f" width="1200" height="954" data-path="images/order-items/order-items/PixPin_2025-05-27_17-03-23.png" />
</Frame>

In the `Fulfillment` section of the detail page, you can view all relevant information about this Order-Item as it appears on the fulfillment platform, such as Printify.

<Frame>
  <img src="https://mintcdn.com/mockspark/4DeP8kx9tdJD6T-P/images/order-items/order-items/PixPin_2025-05-27_17-04-15.png?fit=max&auto=format&n=4DeP8kx9tdJD6T-P&q=85&s=fe2b0dc380f5aa1e71dcb2853a5f87e8" width="1200" height="954" data-path="images/order-items/order-items/PixPin_2025-05-27_17-04-15.png" />
</Frame>

In the `Timeline` section of the detail page, you can view the history of actions and updates related to this Order-Item.

<Frame>
  <img src="https://mintcdn.com/mockspark/4DeP8kx9tdJD6T-P/images/order-items/order-items/PixPin_2025-05-27_17-05-13.png?fit=max&auto=format&n=4DeP8kx9tdJD6T-P&q=85&s=fab4d58a714c61a20db656af6f842f74" width="1200" height="954" data-path="images/order-items/order-items/PixPin_2025-05-27_17-05-13.png" />
</Frame>

## Bulk Actions for Multiple Order-Items

1. On the list page, select the Order-Items you want to take action on. Each row represents a single Order-Item.
2. You can **bulk fulfill** the selected Order-Items or export them as a **CSV** file.

<Frame>
  <img src="https://mintcdn.com/mockspark/4DeP8kx9tdJD6T-P/images/order-items/order-items/PixPin_2025-05-27_16-34-25.png?fit=max&auto=format&n=4DeP8kx9tdJD6T-P&q=85&s=f8152da13bc6da1eccc2d7d5be479d03" width="1200" height="583" data-path="images/order-items/order-items/PixPin_2025-05-27_16-34-25.png" />
</Frame>

## Status of Order-Item Explained

1. **status:** <ColorText color="#3b82f6" text="Generating" /><br />*This Order-Item has been placed and is currently in the queue to render the customer's design into the production files.*
2. **status:** <ColorText color="#eab308" text="Ready to fulfill" /><br />*The production files for this Order-Item have been successfully rendered and are now ready for fulfillment. Please review the details and confirm everything is correct before sending it to the assigned fulfillment platform.*
3. **status:** <ColorText color="#3b82f6" text="Sending" /><br />*This Order-Item is currently being sent to the assigned fulfillment platform.*
4. **status:** <ColorText color="#3b82f6" text="Being fulfilled" /><br />*Fulfillment has started. The product in this Order-Item is currently being picked, printed, or packaged. You can track its progress in the order view on the assigned fulfillment platform.*
5. **status:** <ColorText color="#22c55e" text="Fulfilled" /><br />*This Order-Item has been printed and packaged, but it may not have shipped yet. Please check the tracking details in the order view on the assigned fulfillment platform.*
6. **status:** <ColorText color="#ef4444" text="On hold" /><br />*This Order-Item was paused and needs your attention. Reasons may include stock issues, design problems, or missing info.*
7. **status:** <ColorText color="#6b7280" text="Canceled" /><br />*This Order-Item has been canceled, either by you or by the fulfillment platform.*
8. **status:** <ColorText color="#6b7280" text="Archived" /><br />*This Order-Item has been archived and is now hidden from the list view.*

## Order-Item Process

```mermaid theme={null}
flowchart TB
    A([Customers place orders on the sales platform]) --> B[MockSpark receives Order-Item]
    B --> C[Generate production file]
    C --> D{Is production file generated successfully?}
    D -->|Yes| E[Order-Item status: \n Ready to fulfill]
    D -->|No| F[Order-Item status: \n On hold]

    E --> H[Merchant checks production file and delivery info]
    H --> I[Send Order-Item to fulfillment platform]
    I --> J{Is Order-Item sent successfully?}
    J -->|No| L[Order-Item status: \n On hold]
    J -->|Yes| K[Order-Item status: \n Being fulfilled]

    K --> M[Fulfillment platform completes production and shipping]
    M --> N{Is there an error from the fulfillment platform?}
    N -->|Yes| O[Order-Item status: \n On hold]
    N -->|No| P[Order-Item status: \n Fulfilled]

    P --> Q([Receive ❤ positive feedback from customers])
```
