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

# Substitutions in Fulfiller UI

If the [Substitutions feature](/pages/substitute-products-overview "Substitute Products Overview") is configured and a product is unavailable after an order has been placed, fulfillers can substitute a similar product during the fulfillment process.

<Card title="Watch: Product Substitutions in Fulfiller" icon="circle-play" href="/video/product-substitutions-in-fulfiller" horizontal data-rec="video">
  See how to handle product substitutions during fulfillment
</Card>

## View Pre-Fulfillment Substitutions

If a substitution was already performed on the shipment, (as either an automatic substitution or from the Admin UI), then the original line item and the substitute will be displayed in separate tables on the Fulfiller UI's shipment details.

<img src="https://mintcdn.com/kibocommerce-59e68a4a/11fMEclnoleINoq4/img/ffui-admin-substitute.png?fit=max&auto=format&n=11fMEclnoleINoq4&q=85&s=839a19fc17a6f75bc801e30976ca99cc" alt="Shipment details with a table for substitutes" width="1352" height="633" data-path="img/ffui-admin-substitute.png" />

This distinct line item will continue to be reflected in fulfillment steps such as Validate Stock, where you can update the item's In Stock quantity and remove the substitute if needed.

<img src="https://mintcdn.com/kibocommerce-59e68a4a/Qcx3IIpxeL0zyroM/img/auto-sub-validate-stock.png?fit=max&auto=format&n=Qcx3IIpxeL0zyroM&q=85&s=232418edc53559c6d4da7a1ac536d968" alt="The Validate Stock step with a substitute item" width="1364" height="396" data-path="img/auto-sub-validate-stock.png" />

If the substitute product was a bundle, each component product and their quantities will be displayed underneath the bundle name. Components cannot be removed individually.<img src="https://mintcdn.com/kibocommerce-59e68a4a/v_dzrGLoq2v4wGiy/img/bundle-substitute-ffui.png?fit=max&auto=format&n=v_dzrGLoq2v4wGiy&q=85&s=9d46183d538d63168142767350564f0a" alt="An example of a bundle substitute product" width="1838" height="290" data-path="img/bundle-substitute-ffui.png" />

## Perform a Manual Substitution

When an STH, BOPIS, or Delivery (not Assembly or Curbside) shipment item is eligible for substitution, the option to perform a manual substitution will be available during the Validate Stock step. To be eligible, substitutions must be configured for the product and the shopper must not have [opted out of substitutions](/pages/shopper-preferences "Shopper Preferences") while placing their order.

Manual substitutions will not be available if an automatic or Admin UI substitution has already occurred for that item. However, you can still validate stock, reject, or reassign it just like any other line item.

1. At the Validate Stock step, if the In Stock Quantity is less than the required Quantity then **Substitute** will appear next to that line item. Click this to begin the substitution process.<img src="https://mintcdn.com/kibocommerce-59e68a4a/vX_cCc72BnHnRWN5/img/validate-stock-substitute.png?fit=max&auto=format&n=vX_cCc72BnHnRWN5&q=85&s=e0f51c76270280c8accbe63000f8a4a0" alt="The Validate Stock step with a callout for the Substitute button" width="1868" height="486" data-path="img/validate-stock-substitute.png" />
2. Eligible substitutes and their available inventory at the fulfillment location will be displayed. If the shopper [selected a preferred substitute product while placing the order](/pages/shopper-preferences "Shopper Preferences"), then their selection will be the only option displayed. **<img src="https://mintcdn.com/kibocommerce-59e68a4a/7XXCwOQjUsW_CZYB/img/substitute-selection.png?fit=max&auto=format&n=7XXCwOQjUsW_CZYB&q=85&s=917bf088f85f6800dd968def4bd98512" alt="The Substitute Items In Stock modal with a substitute item selected" width="1662" height="280" data-path="img/substitute-selection.png" />**
3. Enter a **Reason** for the substitution and the **Substitute Quantity** of each product you want to substitute with. If the product is a bundle, it will appear as one line item containing all components (such as the example shown in the previous section).
4. Click **Confirm**.
5. The substitutes will be displayed in a new table underneath the original line items, where you can click **Remove** to remove them from the shipment if desired. <img src="https://mintcdn.com/kibocommerce-59e68a4a/yPPx2ALUR4FHFmVl/img/proceed-validate-stock.png?fit=max&auto=format&n=yPPx2ALUR4FHFmVl&q=85&s=2297947b02b1fa981cfc9f154bf9efbb" alt="The Validate Stock step with the Substitutes table" width="1871" height="617" data-path="img/proceed-validate-stock.png" />
6. You can now continue with the fulfillment process as usual. The substitute item's inventory will be allocated while the original item's quantity will be deallocated. The substitutions will also be included on any packing slips and pick sheets.

Once a substitution has been made, information about the item and substituted quantity is listed on the shipment details and can be displayed in Shipment Confirmation notifications.

<img src="https://mintcdn.com/kibocommerce-59e68a4a/7XXCwOQjUsW_CZYB/img/substitutes-in-shipment-details.png?fit=max&auto=format&n=7XXCwOQjUsW_CZYB&q=85&s=1eaf4d54ee13c6566ee4ae1318566b25" alt="Shipment details with a callout for the Substitutes table" width="1868" height="841" data-path="img/substitutes-in-shipment-details.png" />

## Cancel and Return Substitutions

If the original line item is cancelled from the shipment, any associated substitute item(s) will be removed from the shipment as well.

If a substitute item is returnable, then it will be listed in [the Create Return and Process Return modals](/pages/fulfiller-returns). Substitutes will be labelled to help identify them and which shipment item they were originally substituted for.

<img src="https://mintcdn.com/kibocommerce-59e68a4a/RFia3SXPeyM44geJ/img/return-with-substitutes.png?fit=max&auto=format&n=RFia3SXPeyM44geJ&q=85&s=58bacac46ec76a31145d2ab37958f1e0" alt="The Create Return modal with substitute items listed as returnable products" width="3260" height="1388" data-path="img/return-with-substitutes.png" />
