Shopify Subscription Variant Unavailable or Archived
Root cause
The product variant referenced in the subscription contract has been archived, deleted, or set to unavailable in Shopify, making it impossible for the subscription billing system to create an order for that variant even when the billing attempt succeeds.
Symptoms
- • Shopify subscription billing attempts succeed (payment collected) but orders are not created
- • Shopify Admin shows the subscription product variant as archived or unavailable
- • New subscriptions cannot be created for the same product variant
- • Customers on subscriptions for the unavailable variant continue to be billed but do not receive product
How to fix it
Identify all active subscriptions referencing unavailable variants
Query all active subscriptionContracts via the Shopify Admin API and extract the variant IDs from each contract's lines. Cross-reference these variant IDs against your product catalog using the product/variant API to identify any that are archived or unavailable. Build a list of affected subscription contract IDs and their variant IDs — this is your remediation queue.
Update each contract to reference an available replacement variant
Use subscriptionContractUpdate to update each affected contract's lines to reference an active, in-stock replacement variant. If the original product was discontinued, contact affected customers before updating — changing their subscription product without notice creates support tickets. For the same product with a new variant ID (e.g., a SKU refresh), the update can be made silently.
Establish a pre-archive check for subscription-referenced variants
Before archiving any product variant, check whether it is referenced in active subscription contracts. Add this check to your product management workflow: query subscriptionContracts with the variant ID before archiving. If the variant is referenced, migrate subscriptions to a replacement variant before archiving. Archiving a variant in use by active subscriptions creates silent billing failures.
Frequently asked questions
Will archiving a Shopify product variant cancel subscriptions using it?
No. Archiving a variant does not automatically cancel subscriptions that reference it. The subscriptions remain ACTIVE and continue billing, but the billing attempt will fail to create an order because the variant is unavailable. Customers are billed for a product they do not receive — the worst possible subscription experience.
How do I handle variant ID changes when a product is reformulated or repackaged?
Create the new variant before archiving the old one. Use the subscription contract update API to migrate all active subscriptions to the new variant ID. Only archive the old variant after confirming zero active subscriptions reference it. For large subscription bases, stagger the migration — update in batches to avoid API rate limits and give time to catch errors before migrating the full subscriber base.
Detect this error automatically
Free cross-stack scan finds all billing errors in 60 seconds.
Run Free Scan →