Product Bundle QC using Blade

Some stores use virtual SKUs or product bundles in Shopify, where a single item on the order represents multiple physical products. For example, a SKU like BUNDLE-X3 may include three units of a physical variant such as

2 min readUpdated Oct 1, 2026

Some stores use virtual SKUs or product bundles in Shopify, where a single item on the order represents multiple physical products. For example, a SKU like BUNDLE-X3 may include three units of a physical variant such as SKU-X. By default, these virtual SKUs are not recognised in Swap Returns, which operates on physical variants.

Swap now supports the ability to return these virtual bundles by unpacking them into their component products during the return process.


How It Works

Once enabled, Swap will automatically translate eligible virtual SKUs into their physical components when the customer enters their order in the Return Portal. This allows customers to return individual items from a bundle without confusion or manual intervention.


How to Set Up Virtual Bundle Returns

To enable this feature, you will need to add a metafield to each virtual bundle variant in Shopify.

  1. Go to admin.shopify.com
  2. Click "Settings"
  1. Open "Metafields and metaobjects"
  1. Open "Variants"
  1. Click "Add definition"
  1. Add a "Name"
  1. Click "Select type"
  1. Select "JSON"
  1. Add the JSON SchemaExample format:{
    "BundledItems": [
    {
    "BundledVariant": {
    "VariantID": "56327360184701",
    "Qty": 3
    }
    }
    ]
    }
  1. Click "Save"
  1. Close the settings
  1. Go to "Products"
  1. Open the bundle item
  1. Open the variant
  1. Scroll down to "Metafields"
  1. Add the JSON Schema
  1. Make sure to enter the correct Variant ID
  1. Add the correct quantity
  1. Click Save

Example with Multiple Products

If a bundle consists of multiple product, you can use the following JSON schema.

{  "BundledItems": [    {      "BundledVariant": {        "VariantID": "variantid1",        "Qty": 2      }    },    {      "BundledVariant": {        "VariantID": "variantid2",        "Qty": 1      }    }  ]}

Requesting Access

To use this feature, please contact your Swap account manager. They will ensure enablement of the functionality for your store and ensure it works as expected with your setup.