Restricted states
Some items can't be shipped to certain states. The app copies EJD's monthly list onto each product, keeps states you add yourself, and holds any order that would ship a restricted item there.
Some items can't legally be sold or shipped to certain states, such as stains and cleaners over a state's VOC limit. EJD lists them in a monthly report. The app copies that list onto each product as a Restricted states field, and holds any order that would ship a restricted item to one of those states.
What it stops, and what it doesn't
- Orders to EJD. An order that would ship an item to a state it's restricted in is held with
ORDER_STATE_RESTRICTED, in review and automatic mode alike, and never sent to EJD until you deal with it. See The order card and its checks. - Not the sale itself. Shopify's checkout doesn't read this field, and the app doesn't add a checkout rule, so a shopper in a restricted state can still buy the item. The hold catches it before it ships from EJD.
- Not items you ship yourself (self-managed or store-only). Watch those yourself.
Where it shows
- In Shopify: on the product page under Metafields, as Restricted states, for example
AZ, CA, CO. Blank means not restricted anywhere. - On a run: changes are listed on the Titles and details tab, as "Restricted states: AZ, CA → AZ, CA, CO". States of your own that the app keeps are noted ("your own TX kept").
When it changes
EJD sends the report once a month. The next catalog run writes only the differences: a state added, a state removed, or the field cleared when an item leaves the report. New products get their states when they're created. Every change is listed on the run before you apply it, and undoing the run puts the old values back.
Until the first report has been loaded, the app doesn't touch the field, so values you already have stay.
States you add yourself
You can add a state to an item yourself, for example for a local rule EJD doesn't cover. The app keeps it on every run, on top of EJD's states. An item EJD stops restricting keeps your states.
- To take one of your own states off, remove it in Shopify. The app doesn't put it back.
- The first run with a report sets every product to match EJD's report, so a state you typed in before then is removed. Add it again afterwards and it stays.
- If you add a state that EJD later adds too, it counts as EJD's from then on, and comes off if EJD drops it.
If you think EJD's report is wrong for an item, report a data problem.
HOLD_STATE_RESTRICTION_CLEARS
EJD's new report would remove far more restrictions than usual at once, so the app held every change that removes a state. A report that was cut short would look exactly like this, and removing legal restrictions by mistake is costly. Changes that only add states aren't held.
- Open the run from the alert and select the Held tab. The alert names the states losing the most restrictions.
- Compare a few with EJD's report.
- If the items really are no longer restricted, select Approve (or Approve all). If the report looks incomplete, select Skip and contact support.
STOP_STATE_REPORT_STATE_LOST
EJD's new state restriction report wasn't used, because a state that had restricted items last time is missing from it, or has no items marked. A whole state's restrictions vanishing in one month is far more likely a broken export than a change in the law.
- Nothing for you to do. Your store keeps its current restricted states, and runs keep using the last good report, so new products still get their states.
- Striven checks the file with EJD. A corrected report is used as usual. If the state really did lift every restriction, Striven uses the held report once EJD confirms it.
WARN_RESTRICTED_STATE_TYPE
Your store already has a restricted_state field of a type other than single line text, so the app can't write it and leaves it alone.
- In Shopify, go to Settings > Custom data > Products.
- Open restricted_state and change its type to single line text, or delete the definition so the app can create it.
- The next run writes the field.
WARN_STATE_REPORT_STALE
Striven only. No new valid state restriction report has arrived in 40 days, though EJD posts one each month. Every store keeps the last report's states, and orders are held against them, so they're going out of date. Look on Platform for a held report, check EJD's website file, or upload the latest report there. The alert clears when a new report is used. On Catalog, dealers see the report marked late after 45 days.
Good to know
- California Prop 65 warnings aren't covered. EJD's files have no Prop 65 information.
- Alaska isn't covered. EJD's report has no Alaska column. If you ship to Alaska, check restricted items yourself.
- If a report arrives in a layout the app can't read, it's blocked and nothing changes. See A file changed format.
Technical details
Show the exact rules, for the technically minded
- Restricted states: product metafield
custom.restricted_state, single line text: two-letter state codes, sorted, comma-separated (AZ, CA, CO), blank for none. The app creates the definition if it's missing, readable by your theme. - Has state restrictions:
custom.does_item_have_state_restrictions, filled from the same report in the same step (your own states count too): yes when the product has restricted states, no when it has none. Written in your store's existing words:Yes/Noif that's what your products hold, otherwiseY/blank.YandYescount as the same, and so doNo,Nand blank, so a product is never rewritten just for spelling. EJD dropped this column from its restrictions file in November 2026, which is why it's filled from the state report. - Your own states: the app remembers the states it last copied from EJD onto each product. Any other state on the product is yours and kept. Undoing a run restores what it remembered too.
- The clear hold (
HOLD_STATE_RESTRICTION_CLEARS) trips on any of: the field emptied on more than 30% of products that have it; more than 30% of all product-state pairs removed (a product restricted in 3 states counts 3) and at least 25; more than 30% of one state's pairs removed and at least 25 (for example 140 of 400 CA restrictions). - The state-lost stop: a state with restricted items in the last report has no column in the new one, or its column has no "Y". A column marked with something other than "Y" ("X", "1") blocks the report as a format problem. Once Striven releases a held report, later reports are compared with it.
- Report quirks: EJD's "Global" column isn't used (items restricted everywhere are listed state by state). An item EJD lists more than once gets every state from every row.
- Staleness: Striven is alerted after 40 days without a new valid report; Catalog shows it late after 45.