Sell via draft orders

The Mulberry app includes two Admin blocks for draft orders: one attaches warranty plans to eligible products, the other adds package protection to the order. Both work directly from the Shopify Admin, which covers manually built orders, phone or wholesale sales, and any flow that doesn't go through the storefront checkout. You add the blocks you need to the draft order detail page, pick the protection, and complete the order as usual.

📘
What draft orders are for
Draft orders let you build an order manually in the Shopify Admin — common for phone, B2B, and wholesale sales. The Mulberry blocks bring warranty plans and package protection into that flow.

🚧
Populate customer and address before completing the order
Mulberry can only service the attached plans — and the customer can only file a package protection claim — if the draft order has a customer with first name, last name, email, and a shipping address. Fill these in on the draft order before you complete it.

❗
Add protection last, then reload the page
The draft order page works from its own copy of the line items, taken when it loaded — it doesn't see lines a Mulberry block just added. Until you reload, the Payment totals don't include the protection (don't quote them to the customer), and saving a page edit or completing with Payment due later submits the older copy, silently dropping the protection lines. So: finish building the draft first, add protection last, then reload the page and confirm the Mulberry lines are listed under Products before you quote the total or complete the order.

Prerequisites

Before you start, make sure:

The Mulberry Product Protection app is installed and connected on your Shopify store. See Install the Mulberry app.
For warranty plans: the draft order contains at least one product that is eligible for warranty coverage. Package protection only needs the draft to have items on it.
For package protection: shipping insurance is enabled on your Mulberry account. Contact your account manager if you're not sure.

Add the Mulberry blocks to the draft order

Blocks are added per draft order from the Blocks panel on the draft order detail page.

In the Shopify Admin, open the draft order (Orders → Drafts, then select or create one).
In the Blocks section of the draft order detail page, click Add block.
Select the block you want:
- Mulberry Product Protection — warranty plans for eligible products.
- Mulberry Package Protection — package protection for the order.
Repeat for the second block if you need both.
(Optional) Click the pin icon in a block's upper-right corner to keep it on every future draft order automatically.

You should now see the blocks you added at the bottom of the draft order page, each with its own heading.

📘
Nothing to offer
Mulberry Product Protection reads "No warranty offers available for items in this draft order" when none of the products are eligible for coverage — confirm the products have offers configured in Mulberry. Mulberry Package Protection reads "Package protection isn't available for this draft order" when shipping insurance isn't enabled on your account or the draft has no items yet.

Add a warranty plan

The Mulberry Product Protection block shows one eligible product at a time, with the available plans rendered as buttons.

Use the ← and → arrows to move between eligible products. The N of M counter shows your position.
For the displayed product, click a plan button — labelled by duration and price, for example Add 1 Year - $29 or Add 6 Month - $12. Plans are listed shortest duration first.
The button shows Adding... while the plan is attached, then a green Warranty added successfully! banner appears and the plan is removed from that product's button list.

You should now see the warranty added as a new line item on the draft order, and the plan you selected no longer offered for that product in the block.

Add package protection

The Mulberry Package Protection block quotes the premium from the draft's current items — subtotal × your customer rate, the same calculation as at checkout (see Shipping Insurance). Warranty plans already on the draft count toward that subtotal.

Click the Add for button — it's labelled with the quoted premium, for example Add for $10.70.
The button shows Adding..., then a green Package protection added successfully! banner appears and the block reads Added for $10.70 with a Remove button.

You should now see a Mulberry Shipping Protection line item on the draft order for the premium amount. Click Remove in the block to take it off again.

🚧
Re-price if the draft changes
The premium is quoted against the draft's items at the moment you add it. If the draft changes afterwards — quantities, products, added warranty plans — the block warns The draft has changed since package protection was added and offers an Update to button with the corrected premium. Click it to re-price before completing the order, so the customer is charged and insured at the right amount.

📘
Refresh to see new lines in the order summary
A Mulberry block updates itself immediately after you add a plan or package protection. The draft order's main line-item summary elsewhere on the page won't reflect the new line until you refresh — which you should do before completing the order anyway.

Complete the draft order

When the draft order has all its products, the protection, and a customer with a shipping address, reload the page, confirm the Mulberry lines are listed under Products, and complete it as usual (Collect payment / Mark as paid, or send the invoice).

Each warranty line item carries the attributes Mulberry needs to tie it back to the protected product (_warranty_offer_id, _warranty_duration_months, _product, _variantId), and a package protection line carries its own (_shipping_insurance, _shipping_insurance_premium). When the draft order becomes a real order, the plans are registered and the shipping insurance policy is recorded with Mulberry automatically — no manual entry or upload required. See Register the sale for how completed orders are picked up.

👍
That's it
Once the order is completed with a customer attached, the customer's warranty contracts and package protection coverage are created automatically, and they can file claims and receive service. See How claims work.