Miinto feed for Shopify

Miinto's Product Engine fetches every partner feed every thirty minutes, and that schedule is fixed. Miinto will not delay or accelerate it for one partner. The file is the whole catalogue each time, because delta updates are not supported, served over HTTP/HTTPS or FTP from a filename that must never change. There is even a speed budget: the download may take no longer than 15 seconds, with the first byte inside 5.

That is exactly Feedflock's hosted-URL model: one stable address, regenerated every hour, that you paste into the integration once. The format is TSV or CSV in UTF-8 with Unix line endings and one header row. Column order does not matter, column names are case-sensitive, and every column you use must be in the header even where the value is blank.

Miinto's mandatory set is larger than most: id, item_group_id, brand, title, color, size, description, material, madein, image_link, the stock count and both price columns. The title rule is the one most feeds get wrong. Miinto states twice that brand name, size, id and colour are not accepted in titles, which is why the template sends the plain product title and lets the size and colour columns do that work.

Some values have shapes of their own. The size must come directly from the producer. Miinto will not accept your conversions, and when the label carries a country code, the code is part of the value: 36 IT, 38 FR, 8 UK. gender is a three-value enum, M, F and U; there is no kids value, so a kids' product is declared through its category path, like Kids > Shoes > Sneakers. And gtin is optional, unusual for a marketplace, but when present it must be 9 to 13 digits with a valid check digit, so an 8-digit EAN needs a leading zero and a 14-digit GTIN is outside the window.

Miinto's price is an integer with the cents appended, including VAT: 4900 is 49,00 €. The currency lives in the column name itself (c:retail_price_EUR:integer), with one column pair per sales channel: the EUR columns serve the Dutch, Belgian, Italian, Finnish, French, German and Spanish storefronts, while Denmark, Sweden, Norway, Poland, Switzerland and the UK read their own currency columns. And a price that does not exist must be an empty cell: 0 is a price, blank is 'no price in this currency'.

Stock is a plain count in c:stock_level:integer, and there is no availability element at all. The old availability column is deprecated. When a size sells out you keep the row and send 0, and Miinto asks you not to remove it for at least an hour. Here is the part to plan around: stock and prices are the only attributes Miinto updates automatically. Rename a product, swap a colour, touch the brand, and nothing changes on Miinto until their side removes the product and the feed re-creates it. item_group_id, brand, color and size are frozen outright after go-live.

Miinto fetches your images itself, under its own rules: https with a certificate from a trusted authority, no user-agent games, no 403 or placeholder, and a link that never changes once the feed is connected. The main image accepts JPG and WEBP, additional images JPG only, and the first picture must be a pack shot on a white background. One rule above all: every row of a variant group repeats the same image_link. Miinto's validator scored differing images inside a group as a critical error even on Miinto's own sample feed, which is why the template defaults to the product's featured image rather than the variant's.

Duplicates are just as strict: the combination of group_id, size, color and brand must be unique, and a repeated combination keeps every product sharing it off the site, not just the extras. Before you connect anything, run the file through Miinto's Feed Analysis Service at proxy-fas.miinto.net: it is public, needs no account, and reports missing headers, deprecated columns and per-item errors with their severities.