Skip to content
Open platform (opens in a new tab)

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.

Note:

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

  1. Navigate to Settings → Products and markets⁠
  2. Click ... on the market's row and select Edit
  3. Click Add product feed under Product feeds
  4. Enter your feed's URL in Feed URL
  5. Select its File format: XML, CSV, or TSV
  6. Optional: If your feed is password-protected, click Authentication and enter both its Username and Password. Cevoid sends them with HTTP basic authentication.
  7. Click Connect to Feed. A preview of your feed shows, and Cevoid fills in the mappings it recognizes.

Name and map the feed

  1. Enter a name in Feed Name, if Cevoid didn't fill it in from your feed
  2. Map each field to a column in your feed: see Field mapping
  3. 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.

FieldRequiredDescriptionUsed for
IdYesUnique identifier for each product variantConnects products across markets so you only tag once
TitleYesThe product nameDisplayed in product tags
LinkYesURL to the product pageWhere visitors go when clicking a product tag
PriceYesPrice, with or without currency symbol (the symbol is removed at import)Displayed in product tags
Image LinkYesPrimary product imageDisplayed in product tags
Item group IDNoGroups product variants together. It's under Other SettingsProduct tagging, product page gallery fallback, and reviews, which a product's variants share
Additional Image LinkNoSecondary product imageShown on hover over product tag
Sale PriceNoDiscounted price if on saleDisplayed alongside regular price
AvailabilityNoStock statusHide out-of-stock products
CategoryNoHierarchical categories, separated by > or /, or by →, |, or - with a space on each sideTagging filter, Library filter, category page galleries
Collection MappingsNoFeed columns whose values become the product's collections, with several collections in one column separated by commasTagging filter, Library filter, collection page galleries
Variant OptionsNoOptions like color and size, with one feed column per optionVariant selection when tagging, product page gallery fallback
BrandNoThe product's brandBrand review widgets, rich snippets, and product rating feeds
GtinNoThe product's GTIN: its UPC, EAN, or ISBNMatching the product across connections, rich snippets, and product rating feeds
MpnNoThe manufacturer part numberMatching the product across connections with Brand, rich snippets, and product rating feeds
SkuNoThe product's SKUMatching the product across connections, rich snippets, and product rating feeds
Tip:

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.

  1. Navigate to Settings → Products and markets⁠
  2. Click ... on the market's row and select Edit
  3. Click the feed's row under Product feeds, or Edit in its ... menu. Edit feed opens, with the feed's settings and mapping.
  4. 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:

StatusWhat it means
SyncingThe feed is syncing now
SyncedThe feed's last sync finished
Synced with warningsThe 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
ErrorThe 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 syncedThe 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 &gt; Tops &gt; 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.

Warning:

Product tags are connected to the product ID. Contact Cevoid support before remapping the ID field.