Automatic warranty start date

On Shopify, Mulberry starts each warranty's coverage on the date you fulfill (ship) the order, not the date the order was placed. When you mark items as shipped, Mulberry listens for Shopify's fulfillments/create event and resets the warranty start date to the fulfillment date — no extra API calls, CSV uploads, or manual steps.

🚧

Installed before February 25, 2026? Re-approve permissions

This feature needs permission to read order fulfillment data, a scope that was added on February 25, 2026. Stores that installed Mulberry before that date keep their warranties and configuration, but the start-date reset stays off until you re-approve the app's permissions (see Re-approve updated permissions). New installs already include this scope and need no action.

How it works

You don't configure anything for this on a standard install — the fulfillments/create webhook is registered automatically when you install the app. For each shipment:

1. A customer places an order that includes a Mulberry warranty. The warranty is registered with the order date as its initial start date.
2. You fulfill the order in Shopify (mark the items as shipped).
3. Shopify sends the fulfillments/create event to Mulberry, which resets the start date of the warranties on the fulfilled items to the fulfillment date.

The start date is taken from the fulfillment's creation timestamp — the moment the fulfillment is created, not when a tracking number is added later.

📘

Where this fits

Warranty registration and the start-date reset both run on Shopify order webhooks that the app subscribes to automatically at install. See Install the Mulberry app for everything install sets up for you.

Prerequisites

• The Mulberry Product Protection app is installed on your store — see Install the Mulberry app.
• The app has permission to read order fulfillment data. New installs (on or after February 25, 2026) have this; earlier installs must re-approve (below).
• You sell warranties on this store, so orders can contain a Mulberry warranty line item to reset.

Re-approve updated permissions

Skip this section if you installed the app on or after February 25, 2026 — your install already grants the fulfillment scope.

1. Log in to your Shopify Admin.
2. Go to Settings → Apps and sales channels, then open Mulberry Product Protection.
3. If prompted to update permissions, click Approve. You should now see the app return to its normal screen with no pending permission request.

👍

No reinstall needed in most cases

Approving the prompt is enough. If you are never prompted, uninstall and reinstall the app — this does not delete your warranties or configuration, and reinstalling re-registers the fulfillment webhook.

Verify it's working

No further configuration is needed after the scope is approved. To confirm end to end:

1. Create a test order that includes a Mulberry warranty.
2. Fulfill the order in Shopify. You should now see the order marked as fulfilled.
3. Open the warranty in your Mulberry dashboard. The start date should now reflect the fulfillment date, not the original order date.

📘

Retries are safe

Shopify may resend a fulfillment event, and re-shipping the same items has no effect — Mulberry ignores duplicate fulfillment events, so the start date won't shift on a retry.

FAQ

What happens with partial fulfillments (multiple shipments)?

Each fulfillment updates the start date only for the items in that shipment. Items shipped in a later fulfillment get their start date set to that later fulfillment's date.

What about orders I fulfilled before enabling this?

The reset applies only to fulfillments created after the feature is active for your store. Previously fulfilled orders keep their original start dates. To adjust an existing order's start date, contact Mulberry support.

Does this work with third-party fulfillment apps?

Yes. Any app or workflow that creates a fulfillment through Shopify's standard fulfillment process triggers the fulfillments/create event and the start-date reset.

A line item didn't update its start date — why?

The reset matches warranties to fulfilled items by their Shopify variant. A fulfillment line item with no variant is skipped. If a fulfilled product's warranty start date didn't move, confirm the fulfilled item is a standard product variant and contact Mulberry support if it persists.