Shipping profiles and freight
The app puts each EJD item in one shipping profile, Brick, Freight or your General profile. You create the Brick and Freight profiles and set their rates in Shopify once.
The app puts each EJD item in one Shopify shipping profile, and the first rule that matches wins:
- Store-only item → Brick. Checked first, always. A store-only item goes to Brick even if EJD also marks it freight.
- EJD says it ships by truck (Fleet or LTL Only) → Freight.
- Everything else → General profile, your store's default, unless it's on a profile you made (see below).
The app only moves items between profiles. You create the profiles and set their rates in Shopify.
Set up the profiles in Shopify
Do this once, before you turn writes on:
- In Shopify, go to Settings > Shipping and delivery.
- Create a profile named exactly Brick. Its rates depend on what you chose for store-only items on Rules:
- Keep them hidden or Show them, not for sale online: give it no shipping rates. That's what stops store-only items from being bought online.
- Sell them online, fulfilled by your store: give it shipping rates only if you ship store-only items yourself. Pickup and local delivery aren't profile rates: turn them on for your store's location under Settings > Shipping and delivery > Local pickup and Local delivery. See Set up local pickup at your store and Sell store-only items from your store.
- Create a profile named exactly Freight, with the rates you charge for truck freight.
- Set your rates in General profile for everything else.
A store with no products yet
Shopify may not let you save a new profile with no products in it. If so:
- Turn writes on without the profiles. The first run creates your online items in General profile. Brick and Freight items wait with
HOLD_PROFILE_MISSING; nothing store-only is put on sale. - Create Brick and Freight, adding any one of those products to each so Shopify saves it.
- The next run moves those products to the profile they belong in and creates the held items.
Why store-only comes first
EJD never ships store-only items. If freight were checked first, a store-only item with a freight note would land on a profile EJD ships from. Checking store-only first makes that impossible.
Profiles you made
Put an item on a profile you made yourself (Hazmat, Oversize, anything other than Brick, Freight and General profile) and it stays there. Runs never move it back to General profile. If EJD later makes it store-only or freight, it moves to Brick or Freight like any other item.
Store-only items
In Settings > Pricing and safety (or on Rules), Items EJD only sells to stores decides whether store-only items are kept hidden, shown on your store but not for sale online, or sold online from your own shelf. Every way, they're on the Brick profile and EJD never ships them.
Where to see profile changes
Open a run on Catalog and select the Shipping tab. Each row shows the move, for example "General profile → Freight", and why. Items EJD moved between online and store-only are on the same tab.
HOLD_PROFILE_MISSING
Your store has no profile named exactly Brick or Freight, so the changes that need it are held. You get a critical alert (and an email, if you set one in Settings > Alerts) that names the profile to create. While it's missing:
- New products that belong in it aren't created.
- Existing items aren't moved into it. A freight item stays on the profile it's on.
- Store-only items are never left buyable online: one that should move to Brick is set to draft instead, whatever you chose for store-only items.
These changes can't be approved. To fix it:
- Create the profile in Shopify as described above, with the exact name.
- Wait for the next run, or apply the waiting run. The held changes are made then.
- The alert clears once no profile is missing.
Which should I use?
Shopify is moving every store from shipping profiles to market-driven shipping by July 1, 2027. The app works with both, and keeps the same rules either way.
- Setting up shipping for the first time? Switch to market-driven shipping first, then set up your rates the way described below. You only set up shipping once, not twice.
- Already on profiles, and it works? There's no rush. Switch in a quiet week before the deadline, not during the holidays, so you can check your checkout afterwards.
- Not sure which you're on? Open Rules. Under Shipping profiles it says which one your store uses.
Switching to market-driven shipping
- In Shopify, go to Settings > Shipping and delivery and follow Shopify's steps to switch. Shopify carries your current rates over.
- Open the app. Within about 10 minutes it notices the switch, tells you on Home, and starts a catalog run. That run tags every EJD item with its shipping class, creates the three collections below, and checks your rates.
- Read the alerts the run raises. Rates Shopify carried over often apply to all products. The alerts say which rate to limit, and to which collection.
- Set up your rates as described below, then place a test order for a regular item and a freight item to check your checkout.
Shopify may let you switch back for a short time, but switching back loses changes you made since. If you switch back, the app goes back to using your profiles on its next check.
Stores on market-driven shipping
Shopify is moving every store to market-driven shipping: rates are set per market, and a rate can be limited to certain collections. These stores have no shipping profiles. The app checks which kind your store is on every run, and Rules says so under Shipping profiles.
On market-driven shipping the rules above don't change. Store-only items still come first, then freight, then everything else. Instead of moving an item to a profile, the app gives it one tag and keeps a collection for each:
| Class | Tag | Collection |
|---|---|---|
| Everything else | Shipping-General |
Shipping: General (EJD items) |
| Freight | Shipping-Freight |
Shipping: Freight (EJD items) |
| Store-only | Shipping-Brick |
Shipping: Store-only (EJD items) |
The app creates the collections. They aren't shown on your store.
Set up your rates once
- In Shopify, go to Settings > Shipping and delivery and open your market.
- Limit your parcel rates to Shipping: General (EJD items). Add your own collections too if you sell other products.
- Limit your freight rates to Shipping: Freight (EJD items).
- Give Shipping: Store-only (EJD items) no rate, unless you sell store-only items online and ship them yourself. Pickup and local delivery are set on your store's location, not as rates.
- Make sure no rate applies to all products. A rate for all products also reaches freight and store-only items.
The app never changes your rates. Every run reads them and tells you what to fix.
SHIPPING_RATES_STORE_ONLY
A live rate applies to all products, or to the store-only collection, so a customer could have a store-only item shipped. EJD never ships store-only items. Until it's fixed, the app keeps store-only items off sale: ones listed for pickup are hidden with the tag Store-Only-Hidden-Rates, and new ones are created as drafts. Limit the rate as the alert says. The next run lists them again.
If you sell store-only items online and ship them yourself, you won't get this alert.
SHIPPING_RATES_FREIGHT_AT_PARCEL
A live rate applies to all products, so freight items can be bought at that rate. Limit it to Shipping: General (EJD items).
SHIPPING_RATES_NO_FREIGHT
No rate covers Shipping: Freight (EJD items), so customers can't check out with freight items. Add a freight rate for that collection.
SHIPPING_RATES_NO_GENERAL
No rate covers Shipping: General (EJD items), so customers can't check out with most EJD items. Add your parcel rates for that collection.
SHIPPING_RATES_UNREADABLE
The app couldn't read your rates, usually because it needs your approval for its updated permissions. Open the app and approve when Shopify asks. Until then, store-only items are kept off sale. If the alert stays after you approve, contact support.
Something looks wrong
- An item is on Freight but isn't freight: see An item routes to Freight but isn't freight.
- All freight items went to General profile: EJD likely renamed a column in its restrictions file. See A file changed format.
- EJD lists an item twice with different values: the catalog run stops and nothing changes. See Held: restriction conflict.
Weight-based shipping
If your shipping rates go by weight, turn on I charge shipping by weight: set billable weights and size tags in Settings > Pricing and safety, and check the Dimensional divisor (139 is UPS and FedEx retail; enter yours if you've negotiated another). Then every EJD item gets:
- A billable weight as its Shopify weight, the one Shopify and Google rate on.
- Its real weight in the product field
custom.actual_weight, for your theme to show. - Ships-Heavy when it weighs 12 lb or more and under 50 lb, and isn't oversize.
- Ships-Over-50lb when it weighs 50 lb or more. Carriers add a surcharge on these; use the tag to charge for it.
- Ships-Oversize when its box is very long or very large (see Technical details).
Freight items (LTL or Fleet) get no size tags: they ship on Freight. If you sell store-only items online, they get the same weights and tags; a store-only item EJD marks LTL or Fleet stays on Brick and gets Ships-Freight instead, so you can charge freight on it or offer it for pickup only.
Tags you put on yourself are never removed.
HOLD_SHIPPING_REVIEW
A run would change shipping weights or size tags on a fifth of your products or more (and at least 500). This is usually the first run after turning weight-based shipping on, or after changing the divisor.
- Open the run on Catalog and select the Held tab.
- Check a few products' weights and tags.
- Select Approve all.
Technical details
Show the exact rules, for the technically minded
- Profile precedence:
custom.distributoris EJD_BRICK →Brick(overrides everything, including freight notes); else EJD's shipping flag containsFleetorLTL Only→Freight; elseGeneral profile, unless the item is on a profile you made. Brick and Freight are enforced on every run in both directions: an item that stops being store-only or freight leaves them. - Shipping flag source: EJD's restrictions file (the shipping column, whatever EJD currently names it).
- Billable weight: the greater of EJD's box weight (
OM_Weight) and its dimensional weight, length × width × height in inches ÷ your divisor. A case item sold by the each weighs its share of the case (box weight ÷ order multiple). A case listing weighs the whole case. - Size tags use the billable weight of EJD's box. Ships-Oversize: longest side 48 inches or more, or length + girth (longest + 2 × the other two) over 105 inches. Ships-Heavy: 12 lb ≤ weight < 50 lb and not oversize. Ships-Over-50lb: 50 lb or more, oversize or not.
- Tag moves: tags are only added, with two exceptions. An item that becomes oversize loses Ships-Heavy. When an item's weight moves to another band, the app moves only the tags it put on itself: its Ships-Heavy comes off at 50 lb, its Ships-Over-50lb comes off under 50 lb.
- Market-driven shipping: read from Shopify's
ShopFeatures.marketDrivenShippingeach run. Classes are product tags (Shipping-General,Shipping-Freight,Shipping-Brick); the new tag goes on before the old one comes off, and new products are created with theirs. Rates are read from every active market with shipping on (Market.delivery, which needs theread_marketspermission). A rate group with no collection condition, or limited to more than 25 collections, counts as covering every product. Store-only safety is checked again when a run is applied. - Mass-change hold: weight or tag changes on at least 20% of your products and at least 500 products wait as
HOLD_SHIPPING_REVIEW.