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 changes made in Recharge don't sync back to Shopify. For example, if a discount reaches its usage limit in Recharge, that status isn't reflected in 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.
How it works
The Shopify discount import feature imports supported Shopify discount codes into Recharge. Imported discounts are available across all supported Recharge channels, including:
- Checkout
- Customer portal
- Merchant portal
- API
If an imported Shopify discount uses customer segments, Recharge verifies that those segments exist before activating the discount.
If the required customer segments don't yet exist in Recharge, Recharge automatically creates and syncs them during the import. While syncing is in progress, the imported discount remains temporarily disabled until syncing completes. This process typically takes up to 30 minutes but may take longer in some cases.
After a discount is imported:
- If you disable a discount in Recharge, then update it in Shopify and run another import, Recharge does not reactivate the discount. This prevents unintentionally re-enabling discounts you disabled.
- Deleting a discount code in Shopify does not delete it from Recharge. To remove an imported discount from Recharge, delete it manually.
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 are not supported, except Shopify customer segments and new customer discounts.
- 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. The Shopify Discount Import feature imports all supported new and updated Shopify discount codes. You can't choose specific discount codes to include or exclude from an import.
-
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. Expired discount codes aren't imported the first time you run a Shopify Discount Import. This prevents Recharge from importing large numbers of historical discount codes that are no longer active.
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. |
