Skip to content
Sign inStart free
Grumeria Wiki

Product feeds and field mapping

Use a CSV, XML or Google Shopping product feed that Grumeria can download from a public HTTPS address. A local file path is not a feed URL.

← All guides

Use a CSV, XML or Google Shopping product feed that Grumeria can download from a public HTTPS address. A local file path is not a feed URL.

Where the feed comes from depends on your shop system. For Shopify, enter https://grumeria.com/api/shopify-feed?shop=your-shop.com as the feed URL (with your store address): Grumeria builds a Google Shopping feed from your store's public product data, no app needed. A feed from a feed app in the Shopify App Store works too. WooCommerce works the same way with https://grumeria.com/api/woocommerce-feed?shop=your-shop.com, no feed plugin needed (it uses the public WooCommerce Store API). For Magento 2, https://grumeria.com/api/magento-feed?shop=your-shop.com works the same way, no feed extension needed (it uses the public Magento 2 GraphQL API); a feed from an extension works too. PrestaShop creates one with a module. Shopware 6 creates it as a product comparison sales channel with the Google Shopping template. JTL-Shop 5 uses the Grumeria plugin.

Map the source fields to product ID, title, link, price, availability and image link. Keep product IDs stable across updates. Add brand and category fields when available so they can be used for search and filters.

Review the import status and product count before publishing. An incomplete replacement catalog is not published when an import exceeds the plan limit or fails the catalog-size checks. Correct the feed and review the next import.

Set up product variants. Grouping is off by default. Under “Product data”, map the stable group ID supplied by your feed to group_id as text or keyword and enable at least one role. Then choose “Reindex completely”; individual item updates are insufficient for an existing catalog. Open “Product variants”, refresh its status and enable grouping once the catalog is ready.

Check variants. Products are grouped only by the explicit group ID supplied in the feed; empty group IDs remain individual products. Test the selector in “Test search” and in your shop: the image, price, delivery status and link always belong to the selected variant. Filter counts represent matching product groups; a group can match several filter values. Each card offers up to twelve matching variants. You can switch grouping off again under “Product variants”.

Provide translated product titles, descriptions and URLs in your feed. Grumeria translates its search controls; it does not translate products or convert prices.

Account setup and the dashboard are available in English and German.

Sign in

Related guides