The Shopify integration
Every Shopify setting in KNKTD OS, what it does, and exactly what syncs in which direction.
KNKTD OS connects to one Shopify store per workspace. Every part of the connection is a separate setting, and almost all of them start off, so nothing reaches your store until you turn it on.
Open it from Settings → Integrations, then the Shopify card under E-commerce. You need permission to manage integrations to change anything, and connecting or reconnecting the store needs an owner or admin.
What syncs, at a glance
| Data | Direction | Starts | Where you turn it on |
|---|---|---|---|
| Products, variants, prices | Shopify → KNKTD OS | Off until you import | Product import |
| Product changes | KNKTD OS → Shopify | Off | Publishing rules |
| Inventory | KNKTD OS → Shopify only | Off | Inventory |
| Starting stock (one time) | Shopify → KNKTD OS | Manual | Inventory |
| Orders, fulfillments, refunds, returns | Shopify → KNKTD OS, plus actions you take in KNKTD OS | Off | Order sync |
| Customers | Shopify → KNKTD OS, plus actions you take in KNKTD OS | With order sync | Order sync |
| Collections | Shopify → KNKTD OS, push by button | Off | Collections |
| Markets | Shopify → KNKTD OS | Off | Markets |
| Price lists | KNKTD OS → Shopify | Off | Markets |
| Metafields | KNKTD OS → Shopify only | Off | Publishing rules |
Inventory is never read back from Shopify after the first import: KNKTD OS owns your stock.
Connect your store
- In Shopify store, enter only the store name, without
.myshopify.com. - Click Connect store and approve access in Shopify.
You'll see Shopify connected. Connecting doesn't import anything yet. It registers the webhooks KNKTD OS needs, and you choose what to import and publish in the cards below.
The Connection card shows:
- Store: the store this workspace is connected to. A workspace stays bound to its first store, even after you disconnect. For a different store, create a new workspace.
- Store access: how many of the Shopify permissions KNKTD OS needs are approved.
- Connection health: Healthy when KNKTD OS reached Shopify as the page loaded, or Reconnect needed when it couldn't.
Reconnect and Approve new access
- Reconnect store refreshes the connection. If Shopify's access expires, syncing pauses and the page asks you to reconnect. Your data is safe and nothing is deleted.
- Approve new access appears when a setting you turned on needs a Shopify permission the store hasn't granted yet, such as order sync or markets. Until you approve it, the store shows Limited access, and product import and location mapping are read-only.
Import products from Shopify
The Product import card brings Shopify products into KNKTD OS and keeps them updated. Click Import products to run it (it becomes Re-sync products after the first sync). Configure import opens the same setup to change the settings only, and saves them with Save setup.
When you import, the Shopify import setup has five steps.
1. Products. Choose which products to bring in by Shopify status: Active (the default), Unlisted, Draft or Archived. Download Shopify products for review is on by default, so you see a preview before anything imports.
2. Matching. KNKTD OS matches each Shopify product to an existing product in this order:
- The saved Shopify link, if it was imported before
- Variant SKU
- Variant barcode
- Product handle, as a backup
SKU and barcode are the most reliable way to match the exact size or color.
3. Field mapping. Each Shopify field (title, description, price, compare-at price, cost, weight, HS code, country of origin and so on) maps to a KNKTD OS field. Set any field to Ignore to leave it untouched in KNKTD OS. Product title, variant SKU, option name and option value are required. Metafields are not imported.
4. Review.
| Setting | Default | What it does |
|---|---|---|
| Sync product changes from Shopify | On | Keeps matched products updated when they change in Shopify. Turn it off if you only use KNKTD OS for product development. |
| Allow new product suggestions | On | Imports Shopify products that don't match anything yet. When off, they're skipped. |
| Generate SKUs for variants without them | Off | Variants with no SKU are skipped unless this is on. |
| Generate barcodes for variants without them | Off | Fills in missing barcodes. |
5. Preview & sync. You always see a preview before anything imports. It shows how many products it would create, update, skip or flag for review. Fix anything under Needs review before you can click Start sync. Common skip reasons are variants with no SKU and duplicate SKUs in Shopify.
After the first import
With Sync product changes from Shopify on, edits in Shopify flow in automatically, a few seconds after Shopify sends them. New products created in Shopify are imported too, while Allow new product suggestions is on. Archived Shopify products that were never linked aren't imported. Mapped fields are overwritten with Shopify's values, tags are mirrored exactly (including removals), and images removed in Shopify are removed in KNKTD OS. Live updates start once someone has run the first import or preview.
A few rules protect your KNKTD OS data:
- The newer edit wins. If you changed a product in KNKTD OS more recently than it changed in Shopify, your version is kept.
- Changes on their way to Shopify win. If a push to Shopify is queued or running for that product, or the last one failed, Shopify's version is skipped until your change has been sent.
- Deleting a product in Shopify never deletes it in KNKTD OS. It's only unlinked.
- An empty product type in Shopify doesn't clear yours.
Locations and inventory
Map your locations
Inventory can only sync once locations are mapped. In the Locations card, click Configure mapping and match each Shopify location to one or more KNKTD OS locations. Their sellable stock is added together and synced to that Shopify location. Unmapped Shopify locations are ignored.
Channel safety stock (default 0) holds back that many units of each variant (each size and color) from each Shopify location, after the mapped locations are added together. A product in five sizes holds back five times the number.
Push inventory to Shopify
Sync inventory to Shopify (off by default) sends sellable stock to Shopify whenever inventory changes in KNKTD OS. It's one-way: stock changes made in Shopify are never read back.
Only variants linked to Shopify, and tracked there, are updated. While new Shopify orders are still being processed, inventory updates wait for them, so stock isn't sent twice.
Sellable stock is on-hand minus reserved minus safety stock, counted in picking bins and in locations without bins. Stock in receiving, QC and returns bins doesn't count. If a product is oversold, Shopify receives a negative number.
A daily check at 06:00 UTC corrects any drift.
Seed stock from Shopify (one time)
Sync inventory from Shopify copies Shopify's current stock into KNKTD OS for mapped locations. Use it once, before turning on Sync inventory to Shopify.
This replaces KNKTD OS on-hand quantities and can't be undone. You confirm by typing I understand. Every change is recorded as an inventory movement. Products with no Shopify stock level are left unchanged. If a Shopify location is mapped to several KNKTD OS locations, the stock goes into the first one.
It's unavailable while Sync inventory to Shopify is on, because KNKTD OS is then the source of truth.
Publish to Shopify
The Publishing rules card controls what KNKTD OS may change in your store.
Sync products to Shopify is the master switch (off by default). When on, saving a product in KNKTD OS updates it in Shopify, and creates it there if it doesn't exist yet. With the Status field on, the Shopify status follows the KNKTD OS status.
When a product is deleted in KNKTD OS:
- Archive in Shopify (recommended): removes it from the storefront but keeps order history. This is the default.
- Delete in Shopify: permanent.
- Leave unchanged in Shopify: keeps the listing as it is.
Choose which fields to send
Every field starts off. Turn on only the ones KNKTD OS should own.
- Product: Title, Description, Status, Handle, Product type, Vendor, Category, Tags, SEO title and description, Fabric, Link size option, Media
- Variant: SKU, Barcode, Price, Compare-at price, Cost, Weight, Taxable, Inventory policy, Track inventory, Requires shipping
- Customs: HS code, Country of origin, Country HS codes
Compare-at price needs Price turned on. SEO fields overwrite whatever Shopify or an SEO app holds. Turning on Country HS codes also runs a one-time import of the country codes already in Shopify, filling only countries KNKTD OS doesn't have yet.
When a field is on and empty in KNKTD OS, it's cleared in Shopify. That applies to description, product type, vendor, tags, SEO fields, SKU, barcode, compare-at price, cost, weight, HS code and country of origin. Title, handle, category, status, price and fabric are never cleared: an empty value is simply not sent.
Metafields
KNKTD OS can also write product and variant metafields, under its own knktd namespace:
- Product: care guide, supplier, customer-facing material and composition, model details, and the size chart (as data, a table and a text paragraph)
- Variant: composition, material, construction, target gender, customs description, supplier name and address, MID, and manufacturer part number
An empty value removes that KNKTD OS metafield from Shopify. The size chart is only published when every size can be identified.
Every product push also fills Shopify's standard category attributes, such as target gender, age group, size, color and pattern (and fabric, when that field is on). Values you set by hand in Shopify for these attributes are overwritten. Metafields from other apps are left alone.
Rules only apply to future changes
Turning on a field doesn't push your existing products by itself. After you save, the Products page shows how many products are behind on Shopify, so you can push them. Shopify may also ask you to approve new access first.
To push a product that isn't on Shopify yet, use Push to Shopify in its page menu; this works even with automatic sync off. For products already linked, select them on the Products page and choose Resync to Shopify. Both follow your publishing rules.
Collections
- Sync Shopify collections (off by default) mirrors your Shopify collections into KNKTD OS and keeps them fresh. Manual collections bring their products; smart collections stay computed by Shopify.
- Push collections to Shopify (off by default) enables the Push to Shopify button on each collection. Nothing is pushed automatically.
- Default sales channels are pre-ticked the first time a collection is published.
- Backfill collections re-pulls them. Collections deleted in Shopify are removed; collections created in KNKTD OS never are.
A collection that exists in Shopify can't be deleted from KNKTD OS.
Orders and customers
Inbound order sync (off by default) downloads new Shopify orders, routes each one to a fulfilling location, and reserves stock. Turning it on needs new Shopify access, so reconnect afterwards.
Sync filters limit which new orders come in:
- Only unfulfilled orders
- Payment status: all, partially paid or more, or fully paid only
- Only orders placed on or after a date
Sync existing orders brings in orders placed before you turned order sync on. Leave the dates empty for the full history. Fulfilled units are recorded as already shipped, so only open units reserve stock, and past refunds don't restock. Running it again skips orders already synced.
From then on, KNKTD OS follows Shopify:
- Fulfillments made in Shopify reduce reserved stock.
- A refund marked as a return restocks; a cancellation releases the reservation.
- Actions you take in KNKTD OS are sent to Shopify: cancelling, marking paid, editing addresses and orders, fulfilling with tracking, refunds, returns and draft orders.
Customers come in with order sync, including their address books. Sync customers re-runs the full import. A customer deleted in Shopify is detached, not erased, so their order history stays.
Markets and price lists
- Sync Shopify Markets (off by default) mirrors your markets, their countries, currencies and price lists. Shopify stays the source of truth for markets, but you can create a new market for a country from the price lists page in Products → Pricing.
- Push price lists to Shopify (off by default, shown once market sync is on) writes your active market rules from Products → Pricing to Shopify as price lists.
- Backfill markets re-pulls them. Removed markets are pruned.
Other settings
- Create discount codes from plans: applying a code-mode markdown plan creates one Shopify discount code per tier, scheduled with the plan.
- Read storefront traffic: adds sessions, conversion, the checkout funnel and traffic sources to analytics.
- Read payment fees: records the actual Shopify Payments fee on every charge, refund and chargeback, going back 24 months. Payouts are read, never changed.
Each of these needs new Shopify access, so reconnect after turning it on.
Check what's syncing
- Sync activity shows what was created, updated, skipped or failed over the last 7 days.
- Sync log (in the menu at the top of the page) lists the latest syncs and live changes in both directions, with the reason for anything skipped or failed.
- Failed product, order and inventory updates from Shopify are retried automatically: a check every 15 minutes picks up failures from the last 48 hours.
If your workspace currency doesn't match your store's, the page warns you. Set workspace currency to … relabels your amounts in the store's currency without converting them, so check prices afterwards.
Disconnect
Open the menu at the top of the page and choose Disconnect. This removes KNKTD OS's access to the store and stops syncing. Imported products, media, mappings, sync history and settings stay in your workspace. The mirrored markets are removed.
Good to know
- Images added directly in Shopify after import are never removed by KNKTD OS. Images that came in through the import are linked, so with the Media field on, removing one in KNKTD OS removes it in Shopify too.
- Country HS codes are merged per country. A country removed in KNKTD OS stays in Shopify until you remove it in Shopify admin.
- Unlinking a product leaves its Shopify listing as it is. Pushing it again creates a new, separate listing.
- Once Sync inventory to Shopify is on, KNKTD OS is the source of truth for stock.
