Using the Shopify Discount Import feature
The Shopify discount import feature allows you to import discount codes created in Shopify into Recharge.
This article explains how the import works, what’s supported, and how to review your import results.
- Shopify Checkout Integration
- Migrated Shopify Checkout integration
Before you start
The import is one-way. You can import discount codes from Shopify into Recharge, but you cannot export Recharge discounts to Shopify.
You must manually start the import from Recharge.
Updates to existing discount codes only apply to new uses of the code. They do not update discounts already applied to subscriptions or past charges. To update discounts on existing subscriptions, see Managing discount codes in bulk.
Recharge imports the usage limit (how many times a code can be used), but not the usage count (how many times it has already been used).
You can import up to 500,000 supported discount codes at a time. If you need to import more, contact Recharge Support. See Managing discount codes in bulk to learn more.
Shopify combined discounts are not fully supported. While you can import them, stacked amounts may not display correctly in Recharge and could cause errors.
Unsupported Shopify discount features
Recharge does not support all Shopify discount configurations.
The following discount types and conditions are not supported and will not import successfully:
- Buy X get Y discounts
- Discounts that apply to multiple products or collections (Recharge supports only one product or one collection per discount)
- Discounts limited to specific customer groups (except new customers)
- Discounts that require a minimum cart quantity
- Product discounts that apply to a single variant or subset of variants (only discounts that apply to all variants on a product are imported)
- Free shipping discounts that:
- Exclude shipping rates over a certain amount
- Are restricted to certain countries
- Apply only to one-time or only subscription purchases
If you use Shopify Checkout Integration, free shipping discounts must apply to both one-time and subscription purchases. When creating the discount in Shopify, select Both under Purchase type.
Import Shopify discounts
Follow these steps to import your discount codes.
-
Confirm that your supported discount codes are created in Shopify.
If you just created a new discount, wait at least five minutes before starting the import.
In the Recharge merchant portal, click Discounts and click Discounts.
Select Import Shopify discounts.
-
If prompted, update your app permissions. Recharge must have permission to read Shopify discount codes before you can import them.
Click Update your app’s permissions.
Approve the requested permissions in Shopify.
Return to Recharge and click Next.
Enter the email address where you want to receive the import report.
Click Import.
The import runs in the background. You cannot monitor progress.
Do not start another import while one is already in progress. If you try, you will see an error message asking you to wait until the current import finishes.
Import time depends on the number of discount codes being created or updated.
Access your CSV report
Once the import is complete, you will receive an email with a link to download a CSV report.
The download link is valid for one hour.
If the link expires, a new link is automatically sent to the same email address.
The report remains accessible for 30 days.
The CSV report lists each discount code and its import status.
Automatic discounts do not appear in the report.
If your CSV file is blank, no supported changes were detected and no discounts were created or updated.
Understand the import statuses in your CSV report
Status |
Definition |
| Created |
The discount was successfully created and can be found in your list of discounts in Recharge. Click Discounts from the merchant portal to view these discounts in Recharge. |
| Excluded |
The discount could not be created in Recharge because it is unsupported. A failure reason will be listed. For more details, see Unsupported Shopify discount features. |
| Updated |
The discount has been updated in Recharge, and any change to the usage limit or the active dates is now reflected in Recharge. This status is shown when you are editing existing Shopify discount codes and importing them to Recharge. Refer to edit existing Shopify discount codes under Additional information. |
| Failed | An error has occurred with the Recharge API. Retry the import. |
Additional information
-
Imported discounts are available across all channels, including:
Checkout
Customer portal
Merchant portal
API
If you disable a discount in Recharge, then update it in Shopify and run another import, Recharge will not reactivate the discount. This prevents unintentionally re-enabling discounts you disabled.
Troubleshooting and FAQ
Visit Discounts Troubleshooting and FAQ for common questions related to discount codes.
