Getting started
1. Install and run your first scan
After installing BorderReady from the Shopify App Store, open the app from your Shopify admin. On the Scan & fix tab, click Run scan now.
A scan reads your active product catalog, syncs current data from Shopify, and checks every product and variant against six rules. Depending on the size of your catalog, this can take anywhere from a few seconds to a few minutes.
2. Understand what got flagged
Once a scan finishes, the Issues to fix panel groups every problem by type. Click an issue type to see the specific products and variants it affects.
Missing country of originVariant
No country of origin set on the variant
Missing HS codeVariant
No HS code set on the variant
Invalid HS code formatVariant
HS code set, but not 6–10 digits
Missing product weightVariant
No weight set on the variant
Invalid product weightVariant
Weight is zero or negative
Missing materialProduct
No material set — applies to every variant of the product
Generic material valueProduct
Material is set but too vague (e.g. "mixed", "fabric")
Vague product titleProduct
Title is empty, generic, or under 3 meaningful words
Missing product descriptionProduct
No description set
| Issue | Level | What triggers it |
|---|---|---|
| Missing country of origin | Variant | No country of origin set on the variant |
| Missing HS code | Variant | No HS code set on the variant |
| Invalid HS code format | Variant | HS code set, but not 6–10 digits |
| Missing product weight | Variant | No weight set on the variant |
| Invalid product weight | Variant | Weight is zero or negative |
| Missing material | Product | No material set — applies to every variant of the product |
| Generic material value | Product | Material is set but too vague (e.g. "mixed", "fabric") |
| Vague product title | Product | Title is empty, generic, or under 3 meaningful words |
| Missing product description | Product | No description set |
3. Apply a fix
Select an issue type, enter the correct value, and choose which affected items to apply it to. Two ways to apply:
- Bulk — set one value and apply it to every selected item at once. Use this when the same value applies to a whole group (for example, setting country of origin to the same value for a batch of items you manufacture in one place).
- Per-item — enter a different value for each row. Use this when items need different corrections (for example, distinct HS codes per product).
Click Apply fix. BorderReady writes the new value directly to the product or variant in Shopify — not just inside the app — so the correction is real and permanent until changed again.
4. Ignore items that don't apply
Some products — gift cards, digital items, services — will never have a real HS code or weight. Select those rows and click Ignore selected instead of trying to fix them. Ignored items stay excluded from future scans until you undo the ignore.
5. Review fix history
The Issues fixed tab lists every applied batch, grouped by issue type, with the value used and how many items it affected. Each batch can be:
- Expanded to see the exact items and their before/after values.
- Edited per item, if a specific value needs correcting later.
- Undone, which reverts every item in that batch back to its original value in Shopify and reopens the related finding.
6. Export for a broker or your own records
On the Export tab, click Run export to download a CSV of your full active catalog with every compliance field. If any issues are still open, BorderReady will ask you to confirm before exporting incomplete data.
Exports are saved to the export history list, where you can re-download or delete them later.
Rescanning
Run a new scan any time your catalog changes — new products, edited variants, or after making changes directly in Shopify. Each scan re-reads current Shopify data, so it always reflects what's actually live in your store.