Source of truth

Every kind of product data has one system that decides it — and it is one answer per kind, not one for your whole account. What each kind covers, who can own it, and what changes when you move it.

Every piece of your product data has exactly one system that decides it. We call that system the source of truth for that data. Everywhere else receives a copy.

The important part, and the part that surprises people: it is not one answer for your whole account. It is one answer per kind of data.

The three kinds

Each can have a different owner, and normally does. A common shape: the catalogue was originally pulled from Etsy, prices are set in MarketplaceHub, and stock is pushed in by a warehouse system over the API. All three are true at once.

Who can own each kind

• MarketplaceHub — you edit it here and every marketplace receives it. This is what the rest of the product is built around.
• A marketplace — that shop decides, and MarketplaceHub copies the value in.
• A file feed — your scheduled CSV or JSON import sets it. Price and stock only.
• Your own system — an ERP or warehouse pushes it over the API. Price and stock only.

Why Amazon and eBay cannot own price or stock

For a marketplace to own price or stock, something has to send changes into MarketplaceHub continuously — not once, but every time a value moves. Two integrations can do that today:

• Shopify sends a webhook the moment a variant changes.
• Etsy has no webhooks at all, so MarketplaceHub polls the shop on a schedule instead.

Amazon and eBay have neither. Naming one of them as your price or stock owner would look like it worked and then quietly do the opposite of what you wanted: MarketplaceHub would start ignoring every other channel's changes on the grounds that they are not the owner, while nothing ever arrived from Amazon to replace them. Your listings would keep whatever figures they last had, indefinitely.

So they are not offered. They can own the catalogue — a content import is a thing all four marketplaces support.

What "demoted to a target" means

When you move a kind of data away from a marketplace, that marketplace does not get disconnected. It stops being asked and starts being told. Concretely:

• Its incoming sync stops. Etsy's scheduled poll is removed; a Shopify subscription stops being treated as a source.
• It keeps receiving everything. The catalogue, prices and stock still publish to it exactly as before.
• Changes made on that marketplace stop reaching MarketplaceHub. If someone edits a price in the Etsy dashboard after Etsy has been demoted, MarketplaceHub will not learn about it — and will overwrite it on the next publish.

That last point is the one worth telling your team about before you switch.

Editing something that somebody else owns

Nothing stops you. If you change a price in MarketplaceHub while a marketplace owns price, the change is applied — and you are warned, in the app and in the API response:

Etsy is your price master, so this price will be overwritten the next time Etsy syncs. Change the master on the Data Flow page if you want this value to stay.

Refusing the edit outright would be worse: sometimes overwriting a value for an hour is exactly what you want, and a system that silently declines to do what you asked is harder to work with than one that does it and tells you the consequence.

Seeing and changing it

The Data Flow page in MarketplaceHub shows the current owner of each kind, which way every connection points, and whether an owner was chosen by you or worked out from your settings. That last distinction matters: if you never made a decision, MarketplaceHub infers one from how your syncs are configured, and says so rather than presenting a guess as a fact.

Change on any card walks you through moving that data to a new owner. Before anything is written, the wizard shows you what stops, what starts, and — for price — which SKUs currently disagree and would be changed.

One thing the switch will not do for you

MarketplaceHub does not invent a price it never had. If your products only ever had per-marketplace prices, there is no MarketplaceHub price to fall back on, and the wizard will refuse to make MarketplaceHub the price owner until there is one. It offers to copy the missing prices from a marketplace you choose, which fills the gaps without touching any listing that already has a price.

That refusal is deliberate. A product whose channels disagree has no single correct price, and picking one for you would be a price change nobody asked for.