Vivino feed for Shopify

Vivino pulls; the merchant hosts. You create an XML feed hosted online as a publicly accessible file, register its URL in the merchant account, and Vivino fetches it automatically, every one to six hours. Their ask is that the data is always current: preferably hourly, at the very least daily.

That is precisely the model Feedflock provides: a hosted file on a stable URL, regenerated every hour from your Shopify catalog. Currency never travels in the feed: it is set per merchant in the Vivino account, and the price element is a plain number. You paste the URL once; there is nothing to re-upload.

Wines on Vivino are identified via their product name, and the name must be attributable to exactly one wine. The prescribed form is producer, wine name and appellation, vintage, and the wine colour, in English or French, and only for wines that are not red. Everything else is explicitly banned: punctuation and promotional text, availability notes, reviewer scores, packaging, bottle size and quantity (they have their own fields), accolades, pricing options and abbreviations. Wines missing any component may not appear at all, and the only escape from the vintage is NV for non-vintage sparkling wines.

Stability matters as much as accuracy: Vivino asks you not to modify product names once the products are live, because a changed name (even a new vintage) is re-listed and unhidden as a new product. And when Vivino's database matches your wine to the wrong page, the fix is a message to merchant support with the two Vivino wine-page URLs, not a feed field. Feedflock builds the name once from your vendor, title and metafields, so the formula holds on every regeneration.

The price in the feed is the total amount charged for the associated quantity: a case of six carries the case price, never the per-bottle price. Outside the US and Canada the price must include tax, and Vivino requires price parity with your own website. Quantity discounts come in two shapes picked by quantity-is-minimum: a fixed case, where bottle_quantity is the case size and the price the case total, or a threshold, where bottle_quantity is the minimum and Vivino extrapolates the price above it.

The stock count follows the same logic: inventory-count is the number of units of this offer (bottles at quantity 1, cases at quantity 6), except with a threshold discount, where it counts single bottles. The maximum value is 9999. And there is no out-of-stock marker at all: an offer whose count drops below 1 must be removed from the feed, which is why Feedflock excludes sold-out variants by default.

Alcohol sits among the optional extras in Vivino's table, yet carries its own sentence: it is mandatory across all markets, formatted as a percentage with the % character and a dot decimal. Shopify has no ABV field, so the template maps it from a metafield you fill once.

For wines bottled after 8 December 2023 and sold in the EU, the labelling data is mandatory; elsewhere it is optional but recommended. Two ways satisfy it: the elabel element with the URL of the wine's e-label page, or the values themselves: energy in kJ per 100 ml, fat, protein and salt in grams per 100 ml, residual sugar in grams per litre, the ingredient list in descending order of volume, plus thirteen allergen flags from milk to mollusc. The flags take Yes/No, while quantity-is-minimum alone uses true/false; the template keeps the two vocabularies apart.