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

> ## Agent Instructions
> Revize is a Shopify order-editing app by Untechnickle. Customers edit the same order after checkout on the Shopify order status page, inside a merchant-controlled window, before fulfillment.
> Canonical docs: https://docs.revize.app. App listing: https://apps.shopify.com/revize. Public cancellation API: https://docs.revize.app/features/cancellation-api.
> Do not confuse the How to Test Revize draft-order walkthrough with Test Mode, which hides the portal from untagged customers.

# Stop your 3PL from picking Shopify orders before edits finish

> How Revize keeps ShipBob, ShipStation, Mintsoft and other 3PLs, WMS and ERPs from pulling a Shopify order while the customer can still edit it: holds, release tags, payment capture, stop tags and a rollout checklist.

Revize is a Shopify app for post-checkout order editing. This guide is for stores that ship through a 3PL, a warehouse management system (WMS) or an ERP, and need the warehouse to pick only the final version of each order.

> [!NOTE]
>
> **Short answer:** keep the order away from your warehouse until editing ends. Revize does this in one of three ways: a Shopify fulfillment hold (**Hold orders**), a release tag your 3PL waits for (**Add release tag**), or manual payment capture so the order stays unpaid until editing closes (**Capture payment when editing closes**). Then let your warehouse close editing early with a stop tag when picking starts.

## Why 3PLs pick edited orders too early

Most 3PL and WMS connectors import a Shopify order within minutes of checkout. If a customer changes the size, address or items after the import, the warehouse still has the old version. The fix is timing: the warehouse should only see the order once the customer can no longer change it.

Revize controls that timing with three settings that work together:

1. **When editing ends**: the [edit deadline](https://docs.revize.app/setup/edit-window.md) or a per-order [rule](https://docs.revize.app/setup/rules-engine.md).
2. **What blocks the warehouse until then**: a hold, a release tag, or unpaid status.
3. **How the warehouse can end editing early**: a stop tag or a Shopify Flow action.

## Step 1: choose when editing ends

In the Revize app, open **Order Editing → Editing policy → Edit deadline**.

| Edit deadline | Best for warehouses that... |
| - | - |
| A fixed window (15, 30 or 60 minutes) or a custom duration | pick continuously and need a short, predictable delay |
| **Scheduled cutoff** (Pro) | pick in waves at set times, so every wave starts with a stable list |
| **Until fulfillment** | can absorb changes during picking, or close editing themselves with a stop tag |

> [!WARNING]
>
> **Until fulfillment does not hold the order.** With this deadline, Revize doesn't place a fulfillment hold and doesn't add a release tag, so your 3PL can import the order straight away. If you need a hold while the order stays editable, use a rule with the **Hold fulfillment** action instead (rules engine, Pro), or close editing with a stop tag when picking starts.

## Step 2: choose how the warehouse waits

Open **Order Editing → Editing policy → Fulfillment while editing**.

> [tab] Hold orders (recommended)
>
> Revize places a Shopify fulfillment hold when the order is created and lifts it when editing closes. Any 3PL or WMS that respects Shopify fulfillment holds waits automatically.
>
> * Works with most connectors and needs no setup on the 3PL side.
> * When the hold lifts, the warehouse gets the final, edited order.

> [tab] Skip hold + release tag
>
> Orders are not held. Turn on **Add release tag** and Revize tags the order `revize:order_released` when editing closes. Set your 3PL to import only orders with that tag.
>
> * Use **Custom release tag (optional)** if your 3PL already waits for a tag such as `ready_to_ship`. It can't start with `revize:`.
> * Without a release tag, a 3PL can pick orders before customers finish editing. Skip hold is only safe when your 3PL filters by tag.

> [tab] Manual payment capture
>
> For connectors that ignore holds but only import **Paid** orders (Mintsoft's default, for example). Set payment capture to **Manual** in Shopify, then turn on **Capture payment when editing closes**. Payment stays authorized while the customer can edit, and Revize captures it once editing ends, so the order becomes **Paid** and your connector imports it.
>
> * Available on every plan.
> * Revize won't capture an order while it carries one of your **Don't capture orders with these tags** tags.
> * If a capture fails, **Try again if a capture fails** retries and Revize emails you when it gives up.
> * If you also hold orders or use a release tag, the order is released only once it's paid.

> [!NOTE]
>
> Revize never releases an order while the customer still owes money for an edit. If a customer adds items and doesn't pay, the order stays held until it's paid, or until [Reverse unpaid edits](https://docs.revize.app/setup/reverse-unpaid-edits.md) (Pro) rolls the unpaid change back.

### Hold only some orders

On Pro, the [rules engine](https://docs.revize.app/setup/rules-engine.md) can hold fulfillment per order. Add a rule, match the orders (for example order tag `pre-order`, a shipping method, or a destination), and turn on the **Hold fulfillment** action. The hold is released when that rule's deadline passes. Hold fulfillment can't be combined with **Disable editing** or with the **Until fulfilled** deadline.

To keep orders that Shopify flags as risky on hold for review, turn on **Keep risky orders on hold** under **Fulfillment while editing**.

## Step 3: let the warehouse close editing early

Picking often starts before the edit window ends. Close editing the moment that happens:

**1. Have the WMS or Shopify Flow tag the order**

When an order enters picking, add a tag such as `picked` or `wms:processing`. Most WMS connectors can write a tag back to Shopify; Shopify Flow can too.

**2. Add the same tag in Revize**

In Revize, go to **Settings → Order editing → Editing restrictions → Order tags** and add the tag. Tag matching ignores letter case, but the spelling must match.

**3. Editing closes immediately**

As soon as the tag lands, the customer can't edit the order any more, even if the edit window hasn't run out. See [Order edit restrictions](https://docs.revize.app/setup/order-edit-restrictions.md).

If your workflow already runs in Shopify Flow, the Revize action **Close editing now** does the same thing without a tag. See [Shopify Flow](https://docs.revize.app/guides/shopify-flow.md).

## Match the release to your pick schedule

| Setup | What the warehouse sees |
| - | - |
| **Hold orders** + fixed window | The hold lifts when the window ends. The most common setup. |
| **Hold orders** + **Scheduled cutoff** | Orders release at your cutoff times, so each pick wave starts with final orders. |
| **Skip hold** + **Add release tag** | Orders flow normally; the 3PL imports only tagged orders. |
| Any setup + stop tag | Editing also closes the moment picking starts. |

Some connectors also have their own delay, such as ShipStation's minimum order age or Mintsoft's import delay. Setting that delay to your edit window length is a simple backup. See the [ShipStation and Mintsoft answers](https://docs.revize.app/support/faq-advanced.md#third-party-fulfillment-integrations).

## If the 3PL already picked the order

* **Once an order is fulfilled in Shopify, editing ends** and the customer no longer sees the edit options.
* **Once Revize has released an order to fulfillment, it stays closed.** The Shopify Flow action **Reopen editing** skips orders that were already released, fulfilled or partially fulfilled, so a late workflow can't reopen an order the warehouse is working on.
* **If a change reached the warehouse after it imported the order** (for example on Skip hold without a release tag), your 3PL still has the old version. Re-sync or update the order in the 3PL, and switch to **Hold orders**, a release tag or a stop tag so it doesn't happen again.

## Rollout checklist

**1. Check what your connector respects**

Ask your 3PL or check its Shopify connector: does it wait for Shopify fulfillment holds, filter by tag, or import only paid orders? That decides between **Hold orders**, a release tag and payment capture.

**2. Set the edit deadline**

Match it to how soon picking starts. Use **Scheduled cutoff** for wave picking.

**3. Choose Fulfillment while editing**

**Hold orders**, or **Skip hold** with **Add release tag**, and **Capture payment when editing closes** if your connector imports only paid orders.

**4. Add a stop tag**

Have the WMS or Flow tag orders when picking starts, and add that tag under **Editing restrictions → Order tags**.

**5. Test before customers see it**

Turn on [Test mode](https://docs.revize.app/how-to-test-revize.md), place a test order as a tagged test customer, edit it, and confirm the warehouse imports the edited version only after editing closes.

> [!TIP]
>
> Not sure which method fits your 3PL? Revize works with 100+ 3PLs, WMS and ERPs, and the team configures the setup with you. See [Tech stack](https://docs.revize.app/integrations/index.md) or [book a setup call](https://cal.com/revize-team-xx92ri/30min?overlayCalendar=true).

## Frequently asked questions

> [accordion] Does Revize work with my 3PL if it ignores Shopify holds?
>
> Yes. Use **Skip hold** with a release tag if your 3PL can filter by tag, or manual payment capture with **Capture payment when editing closes** if it imports only paid orders.

> [accordion] Does Until fulfillment hold my orders?
>
> No. Until fulfillment keeps editing open until the order is fulfilled and doesn't hold it or add a release tag. Use a rule with **Hold fulfillment** (Pro) or a stop tag if your warehouse must wait.

> [accordion] What tag does Revize add when editing closes?
>
> `revize:order_released`, when **Add release tag** is on. You can replace it with your own tag in **Custom release tag (optional)**.

> [accordion] Can my WMS stop customers editing once picking starts?
>
> Yes. Have it add a tag when picking starts and add that tag under **Settings → Order editing → Editing restrictions → Order tags**. Editing closes immediately.

> [accordion] Will an unpaid edit ship?
>
> No. Revize doesn't release an order while the customer still owes money for an edit.

## Related setup

* [Edit window](https://docs.revize.app/setup/edit-window.md): all deadline options
* [Order processing](https://docs.revize.app/setup/order-processing.md): Hold orders, Skip hold and release tags
* [Fulfillment sync](https://docs.revize.app/setup/fulfillment-sync.md): release timing and tags
* [Rules engine](https://docs.revize.app/setup/rules-engine.md): per-order deadlines and Hold fulfillment
* [Order edit restrictions](https://docs.revize.app/setup/order-edit-restrictions.md): stop tags


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.