Troubleshooting variant not found errors
Sections
Issue
Recharge uses the variant ID to connect the subscription item on Recharge with the product on your ecommerce platform. If you have recently updated your products or made changes that impact your products on your ecommerce platform the variant ID associated with the subscription item may need to be updated to ensure that orders do not run into errors when they are processed. If the variant ID is not updated the system cannot reference the product associated with the subscription and cannot process the order.
If the variant ID is not updated, Recharge will return a missing variant, variant
not found or variant removed error message.
Environment
- This issue may appear on all platforms but is most likely on Shopify if you use product-based apps or import products to update.
-
Click Customers > Order errors to view charge errors in the merchant portal.
Resolution
To resolve the variant error swap the existing product to the latest version on the customer's profile.
If you would like to process immediately, once the product has been swapped, retry the order by clicking Actions and selecting Retry beside the error charge.
If you have more than 50 missing variant charge errors you can adjust in bulk.
Preventing future errors
The most common cause for a variant change is an update to the product on Shopify. This can include, but is not limited to:
- Adding a new variant option.
- Adding variants to a product that didn't originally have variants.
- Installing applications that interact with your products.
- Removing variant options.
To avoid making changes to your variant IDs, follow these best practices:
- When you update products in Shopify, don't delete the product and create a similar one. Always edit the original product to ensure that the variant ID remains the same.
- When importing products in bulk on Shopify, select Replace any current products that have the same handle to maintain the same variant IDs for your products.
- Review third-party apps that impact products.
