Upload process reference
Internal reference
The correct upload process
How to get a product from the till system onto the shop, clean, so nothing has to be redone. Follow this for every product.
NuEPOS is the source of truth
Every field is made correct here first, never patched by hand in Shopify afterwards. A hand patch is wiped by the next push.
Push to Shopify as a draft
Map the fields correctly. UTF-8, vendor set to the brand, exact tag strings. Nothing goes live yet, draft is the checkpoint.
Verify one product first
Before the full run, check one product end to end. Vendor, tags, weight, stock at both shops, sales channels.
Tags file the product automatically
A product tagged species:dog and type:dry-food files itself into every collection its tags qualify it for. No hand sorting.
Activate and publish
Set the product active and publish it to the Online Store and Point of Sale. A product that is active but on no channel is invisible.
Live and correct
Every page fills itself. New stock from the till flows in already tagged and lands where it belongs.
The one rule that keeps this clean
- Fix data in NuEPOS, never by hand in Shopify. The next push overwrites hand edits.
- Tags are the labels you invent, species:dog and type:toys. They fill the pages and feed the quiz.
- Category is Shopify's own global list, for tax and Google. Collections are the pages people shop.
Category, tags and collections
Three different things that are easy to mix up. Here is the plain version.
Shopify's own fixed global list, the same for every shop in the world. You pick one per product. Its job is tax and getting products onto Google and the AI channels. Not your shop's navigation.
Free text labels you invent, as many per product as you like, for example species:dog or bestseller. They mean whatever you decide, and they are what the smart collections and the Find-Food quiz read.
The pages customers browse, the Dog Food page, the Kong page. They fill by hand one product at a time, or automatically by rule, usually include everything tagged X, which is what tags unlock.
Where the tagging stands
The current position, so everyone is working from the same picture.
Joe is filing products into collections by hand, and it is landing. The category pages are filling as he goes. What is empty is the tags field, which the Find-Food quiz and the smart collections both need. Filing by hand does not feed either, and it does not scale to every new product from NuEPOS.
The plan is a hybrid. Keep Joe's collection filing as the human record of where things belong, and use it to derive the tags. His work becomes the tagging map rather than something done twice. Tags then get pushed from source, smart collections take over the ongoing filing, and the manual assignments stay as a safety net.
The tag vocabulary
The exact tags to push from NuEPOS. Reconciled from the store's collection rules and the Find-Food quiz, so both agree. Lowercase, exact, with the colon where shown.
species:dog species:cat small-pets
type:food type:dry-food type:wet-food type:raw-food type:toys type:treats type:healthcare
lifestage:puppy lifestage:adult lifestage:senior lifestage:all-life-stages
breed-size:small breed-size:medium breed-size:large breed-size:all
dietary:grain-free dietary:sensitive dietary:hypoallergenic dietary:weight-management
bestseller dog-treats new
Three things to know when tagging.
Treats need two tags. A treat carries type:treats so the quiz sees it, and dog-treats so the Dog Treats page fills. Tag both, or a treat shows in one place and not the other.
Raw food is not yet in the quiz. The quiz food gate reads dry, wet, treats and healthcare, not raw. No raw products are stocked yet, so this is fine for now, but if raw food is added later the quiz needs a one line change or it will not show.
Some tags are bare, not namespaced. small-pets, dog-treats and new have no namespace while the rest do. Kept as is to match what the store already uses, do not add a namespace to these three.
Current state, verified 25 July. Products carry no tags. The one exception is a single Kong product tagged stuffing paste, which is wrong and should be replaced. Some collections report product counts, but the products inside them do not actually carry the matching tags, so those counts cannot be trusted. The per-product tag field is the truth, and it is empty. This vocabulary has been checked against both the collections and the Find-Food quiz, so a single push will fill both.
Internal reference. Snapshot, 25 July 2026.
