Support › Catalog

Who owns each product field

Short answer

The app fills in titles, descriptions, photos and other details when it creates a product. After that you choose which ones it keeps updating, and it never overwrites your own edits.

When the app creates a product from EJD's catalog, it fills in every field. After that, you decide which fields it keeps updating. Edits you make in Shopify are never overwritten. EJD's facts, like cost, stock and restrictions, are always kept current.

Choose who owns each field

  1. Go to Settings > Product details > Who owns each product field.
  2. For each field, pick one of the three choices below.
  3. Select Save field ownership.
Choice What the app does
Keep in sync with EJD Updates the field when EJD changes it. If you edit it in Shopify, the app stops updating it on that product.
Set once, then it's yours (recommended) Fills the field in when the product is created, then never changes it. On products already in your store, it adds EJD's photos and fills a blank search listing and category, one time.
Never set it Leaves the field empty on new products. You fill it in.

Every field starts on Set once.

The fields you control

  • Title. Every product needs a title, so the app always sets one at creation. You can choose Keep in sync or Set once. To change how titles are laid out, select Change how titles are laid out.
  • Description. The main text on the product page.
  • Images. EJD's photos. Your own photos are never touched. With Never, the app doesn't touch images at all. When EJD replaces or drops one of its photos, see Image updates from EJD.
  • Search engine listing. The page title and description Google shows.
  • Product type and category. Shopify's product type and the Google product category.
  • Vendor. The brand name.

Products that were in your store before the app keep their title, description, product type and vendor under Set once. Photos, the search listing and the Google category are filled in one time on them, only where blank. Nothing you already set is replaced.

What's filled in depends on your plan. Store and Online add the main image and a basic search listing. Growth adds every image EJD has and the Google product category. If your search text comes from unique content, the app doesn't write its standard search listing.

Always kept in sync with EJD

These are EJD's facts about an item. They're updated on every run and can't be turned off:

  • Cost
  • Price, after your margin floor, department rules, MAP and price overrides
  • Stock and availability
  • Status and discontinued (discontinued items are set to draft, never deleted)
  • Shipping profile (items on a profile you made stay there)
  • Restrictions
  • Case size

The UPC (barcode) is set when the app creates a product, and never written to one that already exists, so your own barcodes stay.

Tags

Tags you add stay. The app only adds and removes its own tags. See Tags the app puts on products.

PRESENTATION_APPROVAL

The first time the app would fill in product details on your store (search titles and descriptions, extra images and their alt text, the Google product category, spec filters, the manufacturer part number), it waits for your OK. A store that came from another tool can have tens of thousands of blank fields, and filling them is a store-wide change.

  1. Open Settings > Product details. The banner Store finishing is waiting for your OK shows how many of each it would fill.
  2. Set any field you don't want filled to Never set it, and save.
  3. Select Approve and fill them in.

Only blank fields are filled, on products that were in your store before the app too. After this it runs with each catalog update without asking again.

EJD's product details

Every EJD product also carries EJD's data as custom fields (metafields): case pack and order multiple, dimensions and weight, hazmat flag and UN numbers, safety sheet link, country of origin, brand, vendor, department, class and product group, MAP, shipping notes and sale restrictions, and EJD's cost. They show by name in Shopify under Settings > Custom data > Products, and your theme can use them. EJD's cost is never shown on your storefront.

With Keep them current when EJD changes them on (the default), existing products get EJD's latest values with each update: a new hazmat flag, a changed box size, a new shipping restriction. Your own fields, and other apps' fields, are never touched.

WARN_FACTS_MASS_CHANGE

EJD changed details on far more products than usual in one day. That's more likely a bad file than real changes, so nothing was written.

  1. Open Settings > Product details. It shows which fields changed and on how many products.
  2. Check a few products against EJD.
  3. If it looks right, select Apply these changes. They're written once; the next unusually large batch waits for you again.

Technical details

Show the exact rules, for the technically minded
  • Spotting your edits. Each time the app writes one of these fields, it keeps a short fingerprint of what it wrote. Before updating a Keep in sync field, it compares the store's value with that fingerprint. If they differ, someone changed it in Shopify, so the field is left alone and counted (shown in Settings > Product details after each run).
  • Products from before the app have no fingerprint, so their fields are left alone, except that a value already equal to EJD's is adopted: its fingerprint is recorded and it stays in sync from then on.
  • One-time fill on existing products: only blank fields (blank photo alt text gets the product title) and only photos the product doesn't have. Photos added this way, and the MPN, stay if you undo a run; the rest is put back.
  • EJD's fields are custom.* product metafields. A value is written only when it really changed (12 and 12.0 are the same), and nothing is ever cleared. The app creates the metafield definitions with names and descriptions. Cost is never storefront-readable.
  • Mass-change hold: EJD fact changes on at least a fifth of your store's EJD products and at least 500 products in one update.
  • Tags on a move between online and store-only: the app takes off the old EJD_ECOM or EJD_BRICK tag and adds EJD's current tags for the item.
  • Case listings: when an item switches to a case listing, "(Case of N)" is added to the title you have.

Related

Still stuck? Open Help and support inside the app to ask about your own store or write to a person.