Migrating from Advanced Shipping Rules

If you’re currently using Advanced Shipping Rules (ASR), you can import your existing configuration into ShipRules AI. The import maps ASR’s zones, product groups, shipping methods, rules, and conditions to ShipRules AI equivalents.

Note

ASR import is available on Pro and Enterprise plans.

Step 1: Export from ASR

1. Open the Advanced Shipping Rules app in your Shopify admin.
2. Go to Settings > Export Configuration.
3. Download the JSON export file.

Step 2: Preview the import

1. In ShipRules AI, go to Settings > Import from ASR.
2. Upload the JSON file you exported.
3. Review the import preview:
   • Zones: How many zones will be created vs. matched to existing zones (matched by country list).
   • Product Groups: How many groups will be created vs. matched by name. Shows how many variant assignments were matched and how many couldn’t be found.
   • Shipping Methods: How many new methods will be created.
   • Rules: How many rules will be imported. Some rules may be skipped if they use ASR features that don’t have a direct equivalent — the preview lists skip reasons.
   • Blended Rates: How many blended rates will be created.
   • Warnings: Any issues the importer found (unmatched variants, unsupported condition types, etc.).

Step 3: Run the import

1. Review the preview carefully. Pay attention to warnings and skipped rules.
2. Click “Import” to run the import.
3. All entities are created in a single transaction — if anything fails, nothing is partially imported.
4. A version snapshot is created with the label “Imported from ASR”.

What gets mapped

ASR concept	ShipRules AI equivalent
Zones	Zones (matched by country codes)
Product groups	Product groups (matched by name)
Shipping rates	Shipping methods
Rate conditions	Rules with conditions
Rate tiers (weight, price)	Rate type configuration (by_weight_table, by_price_table)
Per-item pricing	Rate type configuration (by_items)

After importing

1. Review the imported configuration in the ShipRules AI dashboard. Check that methods, rates, and rules look correct.
2. Test with the Test Rates panel. Simulate a few common checkout scenarios to verify rates match what you expect.
3. Use shadow mode (Pro/Enterprise) to compare ShipRules AI rates against your current ASR rates on real traffic before switching over.
4. Remove ASR from your Shopify store once you’re confident ShipRules AI is producing the correct rates.

Caution

Don’t remove ASR until you’ve verified that ShipRules AI is returning the correct rates. Run both apps in parallel during the transition — Shopify will show rates from both carrier services at checkout.

If something doesn’t import correctly

• Roll back to the version before the import using Version History.
• Check the import preview’s warnings for clues about what was skipped or couldn’t be matched.
• For rules that were skipped, create them manually using the form or the AI prompt box.
• If you need help, contact support with the ASR export file and the import preview output.