HomeSolutionsAboutDocumentation

Disable or Uninstall BundlesIQ

This guide explains how to safely stop BundlesIQ processing, disable specific features, or fully uninstall the app.

Disable Processing (Without Uninstalling)

If you want to stop BundlesIQ from processing orders temporarily while keeping your bundle configurations intact:

Option 1: Disable Order Processing

  1. Navigate to BundlesIQ > Settings
  2. Disable Process orders and/or Process draft orders
  3. Click Save

BundlesIQ will stop processing new orders immediately. Existing bundles and configuration are preserved.

Option 2: Deactivate All Bundles

  1. Navigate to BundlesIQ > Bundles
  2. Open each active bundle and set the status to Inactive
  3. Click Save

This stops BundlesIQ from detecting those specific bundles on orders while keeping the definitions for later reactivation.

Option 3: Use Processing Scope

  1. Navigate to BundlesIQ > Settings
  2. Set the processing scope to Tagged only
  3. Leave the include tags list empty
  4. Click Save

No orders will match the empty tag list, effectively pausing all processing.

What Happens to Existing Orders

When you disable processing:

  • Already-processed orders are not affected — their transformation remains in place
  • Orders in progress (currently being processed) will complete their transformation
  • New orders containing bundles will not be processed and will retain only the ghost SKU line item

Uninstall BundlesIQ

To fully remove BundlesIQ from your Shopify store:

Before Uninstalling

  1. Verify no orders are currently in the BIQ_PROCESSING state (check the Health dashboard)
  2. Consider whether you need to keep the bundle processing tags on existing orders
  3. Note that uninstalling removes the app's access and webhook subscriptions

Uninstall Steps

  1. Navigate to Shopify Admin > Settings > Apps and sales channels
  2. Find BundlesIQ in the list
  3. Click Remove
  4. Confirm the removal

What Gets Removed

Item Removed on Uninstall?
BundlesIQ app access to your store Yes
Webhook subscriptions Yes — Shopify removes them automatically
Order tags (BIQ_PROCESSING, BIQ_READY, BIQ_ERROR, BIQ_REVERTED) No — tags remain on orders
Order metafields (bundles_iq.transformation_audit) No — metafields remain on orders
Transformed order line items No — component line items remain on orders
Ghost SKU products No — your Shopify products are not affected
Bundle definitions in BundlesIQ Preserved — available if you reinstall
Shopify fulfillment holds Released — any active holds placed by BundlesIQ are released during uninstall

What Gets Preserved

  • All previously processed orders remain in their transformed state
  • Ghost SKU products remain in your Shopify catalog
  • Order tags and metafields remain on orders
  • Your bundle configuration data is preserved in BundlesIQ's systems if you choose to reinstall later

Cleaning Up After Uninstall

Remove Tags (Optional)

If you want to clean up BundlesIQ tags from existing orders:

  1. In Shopify Admin, use the order filters to find orders with the BIQ_READY tag
  2. Select orders in bulk and remove the tag
  3. Repeat for BIQ_PROCESSING, BIQ_ERROR, and BIQ_REVERTED tags

Remove Metafields (Optional)

BundlesIQ order metafields (bundles_iq namespace) remain on orders after uninstall. These are not visible to customers and generally do not need to be removed. If you want to remove them:

  • Use the Shopify Admin API or a metafield management app to bulk-remove metafields in the bundles_iq namespace

Ghost SKU Products

After uninstalling BundlesIQ, your ghost SKU products remain in your catalog. You can:

  • Keep them if you plan to use BundlesIQ again or another bundle app
  • Archive them if you no longer sell bundles
  • Delete them if you are sure you will not need them (this is irreversible)

If you keep ghost SKU products active without a bundle app processing orders, customers can still purchase them. The order will contain only the ghost SKU without component expansion. Set ghost SKU products to Draft or Archived status if you want to prevent this.

Reinstalling BundlesIQ

If you reinstall BundlesIQ after uninstalling:

  • Your previous bundle definitions may be recoverable (contact support)
  • You will need to go through the onboarding process again
  • Previously processed orders will not be re-processed
  • You should run the Go-Live Checklist before processing real orders again

Related Pages