Product feeds
Sync your product catalog to Cevoid using product feeds.
Product feeds sync your product catalog with Cevoid, enabling product tags on posts, product-based galleries, and product reviews. Use product feeds when your store isn't on Shopify or WooCommerce: they're available in workspaces set up with Other as their integration. The products a feed syncs show in Products. On another platform or a headless setup, feeds are one part of the general implementation.
Navigate to Settings → Products and markets to configure your feeds.
Adding a feed needs a product feed URL in XML, CSV, or TSV. If you don't have one, share this article with your developer: the field mapping and the example show what the feed needs.
Add a product feed
Each product feed belongs to a market. To add a feed to a new market, create the market first: see Create a market.
Connect the feed
- Navigate to Settings → Products and markets
- Click ... on the market's row and select Edit
- Click Add product feed under Product feeds
- Enter your feed's URL in Feed URL
- Select its File format: XML, CSV, or TSV
- Optional: If your feed is password-protected, click Authentication and enter both its Username and Password. Cevoid sends them with HTTP basic authentication.
- Click Connect to Feed. A preview of your feed shows, and Cevoid fills in the mappings it recognizes.
Name and map the feed
- Enter a name in Feed Name, if Cevoid didn't fill it in from your feed
- Map each field to a column in your feed: see Field mapping
- Click Create feed
The market then waits under Markets ready to sync in Settings → Products and markets until you start its sync: see Sync a new market. After that, it syncs automatically.
Field mapping
Once a product feed is connected, a preview of the feed displays. Map your feed fields to Cevoid's values.
| Field | Required | Description | Used for |
|---|---|---|---|
| Id | Yes | Unique identifier for each product variant | Connects products across markets so you only tag once |
| Title | Yes | The product name | Displayed in product tags |
| Link | Yes | URL to the product page | Where visitors go when clicking a product tag |
| Price | Yes | Price, with or without currency symbol (the symbol is removed at import) | Displayed in product tags |
| Image Link | Yes | Primary product image | Displayed in product tags |
| Item group ID | No | Groups product variants together. It's under Other Settings | Product tagging, product page gallery fallback, and reviews, which a product's variants share |
| Additional Image Link | No | Secondary product image | Shown on hover over product tag |
| Sale Price | No | Discounted price if on sale | Displayed alongside regular price |
| Availability | No | Stock status | Hide out-of-stock products |
| Category | No | Hierarchical categories, separated by > or /, or by →, |, or - with a space on each side | Tagging filter, Library filter, category page galleries |
| Collection Mappings | No | Feed columns whose values become the product's collections, with several collections in one column separated by commas | Tagging filter, Library filter, collection page galleries |
| Variant Options | No | Options like color and size, with one feed column per option | Variant selection when tagging, product page gallery fallback |
| Brand | No | The product's brand | Brand review widgets, rich snippets, and product rating feeds |
| Gtin | No | The product's GTIN: its UPC, EAN, or ISBN | Matching the product across connections, rich snippets, and product rating feeds |
| Mpn | No | The manufacturer part number | Matching the product across connections with Brand, rich snippets, and product rating feeds |
| Sku | No | The product's SKU | Matching the product across connections, rich snippets, and product rating feeds |
Item group ID is strongly recommended because it groups product variants together for better tagging and fallback behavior. If you don't provide Item group ID, Cevoid analyzes URL paths to create groupings automatically.
Reviews uses the same products: the variants Cevoid groups into one product, by Item group ID or by URL path, share their reviews. Google Rich Snippets and Google Shopping product rating feeds need only each product's title and link. Cevoid adds the GTIN, MPN, SKU, and brand from Gtin, Mpn, Sku, and Brand when you map them. Google matches the reviews in a product rating feed to your products best by GTIN.
Use the mapping from your default market
A feed in any market other than your default market can take its mapping from the default feed: the first feed in your default market. Enable Use mapping from primary market under Mapping Sync when you add or edit the feed. A new feed starts with it enabled once your default market has a feed. The feed then uses the default feed's field mappings, Item group ID, variant options, collections, and searchable fields. To change them, click Open default feed and edit the default feed.
Additional searchable fields
Under Additional searchable fields, click Add field to search to make the values of up to 3 more feed columns searchable, such as an article number. Products can then be found by these values when you search for a product to tag. Columns used for the ID, title, link, description, images, price, or categories can't be added.
Edit or remove a feed
Each product feed belongs to a market, and you edit or remove it from that market's settings.
- Navigate to Settings → Products and markets
- Click ... on the market's row and select Edit
- Click the feed's row under Product feeds, or Edit in its ... menu. Edit feed opens, with the feed's settings and mapping.
- Click Save changes once you've made your changes. They apply from the feed's next sync.
To remove a feed, click ... on the feed's row in step 3, select Delete, and click Remove in the Remove this feed? dialog. Cevoid permanently deletes the feed's settings, and the products it synced stay in Cevoid.
Feed statuses
The Status column in a market's Product feeds section shows how each feed's sync went:
| Status | What it means |
|---|---|
| Syncing | The feed is syncing now |
| Synced | The feed's last sync finished |
| Synced with warnings | The last sync skipped products without an ID, and kept only one product for each ID that several products share: hover over the status for the details |
| Error | The feed couldn't sync: hover over the status to see why, when it last failed, and how many times in a row it failed |
| Not synced | The feed hasn't synced yet |
After 10 failed syncs in a row, Cevoid stops syncing the feed's market automatically, and the market waits under Markets ready to sync on Settings → Products and markets. Fix the feed, then start the market's sync there, as in Sync a new market. After that, the market syncs automatically again.
Product feed example
<?xml version="1.0" encoding="UTF-8"?>
<products>
<product>
<!-- Required fields -->
<id>1001-BLK-M</id>
<product_title>Classic Cotton T-Shirt</product_title>
<link>https://cevoid.com/product/classic-cotton-t-shirt</link>
<product_price>29.99</product_price>
<image_link>https://cdn.cevoid.com/image/classic-tee-black-front.jpg</image_link>
<!-- Optional fields -->
<item_group_id>1001</item_group_id>
<additional_image_link>https://cdn.cevoid.com/image/classic-tee-black-lifestyle.jpg</additional_image_link>
<sale_price>19.99</sale_price>
<availability>in_stock</availability>
<category>Apparel > Tops > T-Shirts</category>
<!-- Collections (Optional) -->
<gender>Women, Unisex</gender>
<styles>Casual, Streetwear, Minimalist, Everyday</styles>
<!-- Variant options (Optional) -->
<size>M</size>
<color>Black</color>
</product>
</products>FAQ
What format should feeds be in?
Google Shopping feed schema is most common, but Cevoid supports custom field names that you map during setup.
What file formats are supported?
XML, CSV, or TSV, at most 250 MB per feed.
Can we have multiple feeds per market?
Yes. Add multiple feeds if your catalog is split across files. Usually one is enough.
What if we modify our feeds?
All fields except product ID can be remapped freely. Changes apply after the next product sync. Cevoid syncs each feed about once a day, and when you click Sync products in Settings → Products and markets: see When products sync.
Product tags are connected to the product ID. Contact Cevoid support before remapping the ID field.