↑↓ selectEnter openEsc close

    1. Elbuz
    2. Feeds and marketplaces

    How to match categories and attributes with marketplaces

    19 min readUpdated

    Elbuz links your categories and attributes to marketplace dictionaries in one window, and the export inserts the marketplace codes: the product lands in its section and its filters.

    When you need this:

    • Rozetka or Epicentr rejects products or misplaces them — once matched, the feed carries marketplace category numbers.
    • Products are missing from color or size filters — matched attributes and values go as marketplace codes.
    • You have hundreds of categories — auto-matching covers exact name matches.
    • How many products are ready for OLX or Allegro? — “Publish readiness” counts them and gives reasons.

    Where to start: “Categories” → the “Marketplace mapping” tile → the marketplace tab.

    What matching does

    Which marketplaces the table covers

    You choose the marketplace with a tab at the top. The table columns are labeled with its name — “ROZETKA category” and “ID ROZETKA”, “prom.ua category” and “ID PROM.UA”, and so on; on the Amazon tab they are “Amazon product type” and “Amazon type code”, on the Newegg tab — “Newegg subcategory” and “Newegg ID”.

    MarketplaceWhat gets matched
    Rozetka, Epicentrcategories and attributes together with their values
    Promcategories; the “Unified rate, %” and the rate for “More sales” are set separately
    Cdiscount, Kauflandcategories and category attributes marked as mandatory or not
    Amazonproduct type and the type's mandatory attributes — separately for each Amazon marketplace
    eBay, eMAGcategories — separately for each eBay site or eMAG country; eMAG attributes come from product attributes with the same name
    OTTO, Newegg, Allegro, OLXcategories (subcategories on Newegg); Elbuz fills the marketplace's mandatory attributes from product attributes with the same name — so your attribute names must match the marketplace attribute names
    Etsy, Bol.com, TikTokcategories; the marketplace names any missing mandatory attributes in its response to the publication
    Ceneo, Googlecategories
    Walmart, ZalandoWalmart product type and Zalando silhouette instead of a category; the marketplace names any missing mandatory attributes in its response to the publication

    Not every marketplace needs attribute matching. Where it isn't used, the program says so right in the attributes block: matching the categories is enough.

    For eBay, Amazon, Allegro, eMAG, Kaufland, Bol.com, Cdiscount, OTTO, OLX, Etsy, TikTok, Walmart, Newegg and Zalando, the category dictionary isn't built in — it is loaded from the marketplace with the “Load marketplace dictionary” button. The marketplace must be connected: its import template with a linked account (link code) or a token. Otherwise the program says so.

    The button contacts the marketplace only when the program doesn't have the dictionary yet. If it already does, the button just shows “Marketplace dictionary loaded: items in cache: …” and pulls no new categories.

    The first fork decides everything: if the dictionary is already in the program, there is no request to the marketplace and no new categories. The connection is checked only when the marketplace didn't return the dictionary.
    yesnoyesno, it's OLX or Allegrono, another marketplacenoyesClicked “Load marketplacedictionary”Is this marketplace's dictionaryalready in the program?“Marketplace dictionary loaded:items in cache: …”Request to the marketplace with thetemplate or linked account dataDid the marketplace return thedictionary?Marketplace categories saved to thedictionaryWhatever arrived is saved, no erroris shownIs there a template with connectiondata or a linked account?“The marketplace is not connected:…”The marketplace's error text or“Failed to load the marketplacedictionary”
    • Start or end
    • Action or result
    • Decision: the path depends on the answer

    eBay, Amazon, eMAG: separate matching for each country

    eBay, Amazon and eMAG have a separate category tree for each country, so a list appears next to the tab where you choose the site:

    TabWhat you choose in the listWhat changes
    eBayone of 19 sites: eBay Germany, Poland, USA, UK, France, Italy and othersthe eBay category for that site
    Amazonmarketplace: Amazon.de, Amazon.fr, Amazon.it…the product type and mandatory attributes for that marketplace
    eMAGeMAG.ro, eMAG.bg, eMAG.hu, eMAG.plthe eMAG category in the country's language

    Matching is stored separately for each site: the same category can be linked to eBay Germany and eBay France categories at once. A link made earlier without choosing a site works as the default for sites that don't have their own matching yet. The dictionary is loaded for the site selected in the list.

    The export takes the category for the site the template is set up for: for eBay, the site from the template; for Amazon, the marketplace; for eMAG, the template's country. For OLX, the region is set by the OLX import template — see connecting OLX.

    Mandatory attributes for Cdiscount, Kaufland, Amazon, Zalando, Etsy and eBay

    Cdiscount, Kaufland, Amazon, Zalando, Etsy and eBay accept a new listing only with the attributes mandatory for its category or product type. That's why on these tabs, below the categories table, there is a table of your attributes with a “Cdiscount attribute”, “Kaufland attribute” or “Amazon attribute” column.

    1. Match the category (for Amazon, the product type of the selected marketplace).
    2. Click the category row — your attributes appear below.
    3. For each one, pick a marketplace attribute with the arrow in the column. The list holds the mandatory and optional attributes of the selected marketplace category; the first time you open it, Elbuz loads it from the marketplace.

    The attribute grid has its own columns for these marketplaces: “Zalando attribute”, “Etsy property”, “eBay item specific”. For eBay, first choose a site from the list next to the eBay chip. The marketplace option is picked by name, ignoring case. Multi-value Etsy properties and eBay item specifics are comma-separated. For the Zalando size chart, you enter the chart label and the supplier size; the Zalando brand is taken from the manufacturer. “Publish readiness” shows categories with unmatched mandatory fields once the category's attribute list is loaded: open the category in the grid.

    Zalando tab with the Zalando attribute column
    1Zalando chip
    2Zalando attribute column header
    1. The Zalando chip switches the window to Zalando mapping.
    2. The Zalando attribute column header in the attribute table.
    Cdiscount tab with the Cdiscount attribute column
    1Cdiscount chip
    2Cdiscount attribute column header
    1. The Cdiscount chip is active.
    2. The Cdiscount attribute column header in the attribute table.

    During export, values are taken from your attributes. On Cdiscount, an attribute with a value list accepts only an option the marketplace itself offers. On Amazon, matching doesn't fill attributes with units of measure (weight, dimensions) — Amazon lists them in its response. Elbuz sends the country of origin “Китай” (China), “China” or “CN” to Amazon as the code CN.

    If a mandatory attribute isn't matched, the new listing isn't sent, and the export log lists what's missing. “Publish readiness” helps you find such categories in advance.

    How to match a category, attributes and values manually

    1. Find your category in the top table.
    2. Switch to the marketplace tab you need and pick its category from the list in the cell. The link is saved right away.
    3. Click your category row in the top table — the bottom left table shows your attributes for that category. Picking the marketplace category alone doesn't refresh it: if the table hasn't changed, click the row again. For each attribute, pick the marketplace attribute.
    4. Select an attribute — its values appear in the bottom right table. Match them too: your “Чорний” (black) must correspond to their “Black”.

    Attribute values — the third level

    On Rozetka and Epicentr you match not only the attributes but also their values. It's the most detailed and tedious level, but it decides whether a product gets into a marketplace filter: if your color is “Matte black” and the marketplace dictionary only has “Black”, the filter won't show the product without a value link.

    You don't need to do this for every attribute at once. The ones shoppers actually filter by on the marketplace are enough: color, size, material, memory capacity. The rest go as text and don't affect visibility.

    An order that saves time

    1. Load the marketplace dictionary if it is loadable (all marketplaces except Rozetka, Prom, Epicentr, Ceneo and Google).
    2. Run auto-matching — it covers categories whose names match exactly.
    3. Check the categories with the most products by hand.
    4. Click “Publish readiness” and see how much is left.
    5. Finish the attributes and values for the categories that already go to the marketplace.

    Start with the categories that have the most products. Matching one top-level category often covers hundreds of items, and it makes sense to finish attributes once the feed passes overall.

    How auto-matching works

    The “Run automatic linking” button does the same thing automatically — but far more literally than people expect.

    A link is created only on an exact name match: your category name must be identical to the marketplace category name. So “Laptops” links to “Laptops”, while “Laptops and accessories” links to nothing.

    The second property matters more: auto-matching doesn't overwrite categories and attributes that are already matched. It fills only rows without a link, so a repeat run won't touch your manual category and attribute links. It also leaves manual value links as they are. Prom rates are the only exception — more on that below.

    The name is compared in every language your category name exists in, not only the interface language.

    The run goes through a fixed list of steps, each showing how many were matched: categories for Rozetka, Prom and Epicentr, then attributes for Rozetka and Epicentr, then attribute values for the same two. The summary shows the total number of links and how many were found in this run.

    These seven steps get one more — categories of the open tab's marketplace, if it's eBay, Amazon, Allegro, eMAG, Kaufland, Bol.com, Cdiscount, OTTO, OLX, Etsy, TikTok, Walmart, Newegg or Zalando — the 14 marketplaces whose dictionary is loaded from the marketplace itself. To cover OLX, stay on the OLX tab with its dictionary loaded. For eBay, the step uses the eBay site selected next to the tabs (eBay Germany, eBay Poland or eBay USA).

    The open tab decides how many steps there are. An error in one step doesn't stop the run — it only changes the final message from “Done” to “Error”.
    yesnoyesnoyesnoyesnoClicked “Run automatic linking”Is the eBay, Amazon, Allegro,eMAG, Kaufland, OLX, Etsy orTikTok tab open?Eight steps: seven base ones and“Categories” for this marketplaceSeven base steps: categories,attributes, attribute valuesThe page sends the next step to theserverStep finished without an error?The step row shows new links, thetotal and the time in msThe step row shows “Error”, the rungoes onAny steps left?Did any step fail?“Error” message and the “Close”button“Done” message and the “Close”button
    • Start or end
    • Action or result
    • Decision: the path depends on the answer

    Exact name matches cover a minority of categories: your names and the marketplace's are almost always different. The numbers in the run summary show how many are left to do by hand.

    Attribute values: automatic links are rebuilt, manual ones stay

    The “Attribute values” step treats two kinds of links differently. It rebuilds automatic ones — where your value is identical to the marketplace value: for each of your attributes already matched with Rozetka (or Epicentr), it first deletes them and then recreates them from the current marketplace dictionary. It doesn't touch manual value links.

    • A manual link “Matte black” → “Black” stays after the run.
    • If your value appears verbatim in the dictionary but you manually linked it to another one, auto-matching keeps your choice and doesn't create a second link.
    • The step doesn't touch values of an unmatched attribute.

    The “+” number in the step row is the difference between the number of value links before and after the step, never below 0. On a repeat run with no changes to the dictionary or your values, it's zero.

    So the order is up to you: you can match values by hand before or after auto-matching.

    The Prom categories step also rewrites one field: for all categories already matched with Prom, it takes the “Unified rate, %” and the rate for “More sales” from the Prom dictionary again. Rates you edited by hand in the table are replaced with the dictionary rates after the run.

    If the run breaks off

    The steps are started one by one by the open program page itself, not by a background queue; each step saves its links separately.

    • If a step fails, its row shows “Error”, and the run moves on to the next steps. At the end, you'll see the message “Error” instead of “Done”.
    • The “Close” button appears only after the last step; until then you can't close the run window.
    • If you close the program tab or the browser mid-run, the steps that haven't started won't run. Links saved by finished steps stay.
    • Running it again is safe and creates no duplicates.
    • The values step first deletes the marketplace's old automatic value links and then creates new ones. If the break falls between these two actions, there are no automatic value links for that marketplace until the next run recreates them. Manual value links stay.

    Each step processes the whole catalog in one pass; its row shows how long it took, in milliseconds.

    How to find and remove a wrong link

    Auto-matching compares only the category's own name, without its path. What follows from that:

    • if the marketplace has several categories with the same name in different sections (for example, “Accessories”), auto-matching skips such a category — you match it by hand;
    • matches are searched only among the marketplace's leaf categories — those without subcategories.

    To find such links, compare the “Category” column (your full path) in the categories table with the marketplace column, for example “ROZETKA category”, which holds the marketplace category's full path. Under each column header there is a filter row: type a word there, and the table shows only the rows where it appears in that column.

    The table shows only categories that contain products. Auto-matching also matches empty categories, but you don't see them in this window.

    To remove a link:

    1. In the category row, click the arrow next to the marketplace category name — the “Category selection” window opens.
    2. The window opens with the current marketplace category. To remove the link, clear the selection in the list (Backspace in the selection field) and click “Select” — the marketplace category ID and name in that row are cleared.
    3. Or pick the correct category right away and click “Select” — the link is replaced.
    Category selection window opened over a table row, with Select and Cancel buttons
    1Arrow in the category row
    2Marketplace category field
    3Select button
    1. The arrow next to the marketplace category opens the selection window.
    2. The field is where the marketplace category is chosen.
    3. Select confirms the choice; Cancel closes the window without changes.

    If you removed a wrong link and left the row empty, the next auto-matching run sets the same link again: to it, this is an empty row with the same name match. To prevent this, pick the correct category right away — auto-matching doesn't touch a filled row.

    If you open the “Category selection” window in an already matched row and click “Select” without changing anything, the link stays the same: only an explicitly cleared selection removes it. The exception is a category no longer in the marketplace dictionary: the window opens with an empty selection, so pick a new category, otherwise “Select” removes the link.

    What happens to a link if the category disappears from the dictionary

    The link is stored in your category: at the moment of matching, the marketplace category ID and its full path are written to it. After that, the program doesn't check this record against the dictionary.

    • If the category disappears from the marketplace dictionary, the link keeps the old ID and old name. In the table it looks normal, with no warning.
    • Auto-matching won't fix such a link: the row is filled, and it doesn't touch filled rows.
    • The missing category won't be in the “Category selection” window — pick a new one by hand, and it replaces the old one.
    • Attributes behave the same way: the marketplace attribute ID and name are stored on your side and aren't cleared automatically.
    • Automatic value links are the opposite: every auto-matching run rebuilds them from the current dictionary, so a value no longer in the dictionary disappears from the automatic links after the run. Manual value links are stored like attributes and aren't cleared automatically.

    How many products are ready to publish

    The “Publish readiness” button counts how many products you can actually send to the marketplace and shows the two main reasons the rest won't go:

    • no matched marketplace category — there's nowhere to put the product;
    • no photo at all — marketplaces require at least one image.

    On the Cdiscount, Kaufland and Amazon tabs, the check also lists categories where the marketplace's mandatory attributes aren't matched with yours: “‹marketplace›, category "‹name›": mandatory properties without a mapped attribute — ‹list›”.

    It's a quick check before export: finding the gaps here is cheaper than learning about them from a moderation rejection.

    How links get into the export

    A link does nothing on its own — you need to insert it into an export template. The marketplace category ID is available in the template as a macro.

    MarketplaceWhere to insert
    Rozetka, in the ready-made template, the {category_id_rozetka} macro is already in the categories block, in the rz_id attribute; to pass the Rozetka category in the product as well, insert the same macro into the product tag
    Prom, XMLsame principle: the Prom category ID goes into the portal category tag and the categories block
    Prom, the “Ідентифікатор_підрозділу” (subsection ID) field gets a formula: if the Prom category is matched, use it, otherwise use your own field

    You can see the exact macro names in the export template itself: in the field list they sit next to the regular category fields.

    Scenarios

    Products on Rozetka need to appear in color and size filters

    What to do. The Rozetka tab. In the top table, link the category; in the bottom left, its attributes; and for the attributes shoppers filter by, also the values in the bottom right table. It helps to click “Run automatic linking” first so it covers exact value matches, then match the rest by hand.

    What you get. The Rozetka category and attribute ID and name are written to your category and attribute the moment you pick them, and the export template takes them from there.

    What won't happen. The next auto-matching run won't touch manual value links: the “Attribute values” step rebuilds only automatic Rozetka value links — exact matches with the dictionary. Epicentr works the same way. Other marketplace tabs have no bottom attribute tables.

    Listing products on OLX for the first time

    What to do. The OLX tab → “Load marketplace dictionary” → without leaving the tab, “Run automatic linking” → match the remaining categories by hand with the arrow in the OLX column → “Publish readiness”.

    What you get. An eighth step is added to the run — OLX categories. It links empty rows to OLX leaf categories with the same name.

    “Publish readiness” shows “Ready to publish: … of … products” and, separately, how many have no matched marketplace category and how many have no photo. Only products with the “Export to file (to website)” flag in enabled categories with the same flag are counted.

    What won't happen. OLX attributes aren't matched in this window. The run also performs the seven base steps, so it rebuilds the automatic Rozetka and Epicentr value links and rewrites the Prom rates along the way. Only the Rozetka, Prom, Epicentr, Ceneo and Google tabs have no “Publish readiness” button.

    You need Prom rates from the dictionary

    What to do. “Run automatic linking”. There's no separate run just for Prom: the run always goes through the whole list of steps.

    What you get. For each category already matched with Prom, the Prom categories step rewrites the “PROM.UA Unified rate, %” and “PROM.UA Rate for “More sales”” columns with values from the Prom dictionary. Unmatched categories with an exact name match get both the Prom category and the rates.

    What won't happen. Rates you changed by hand won't be kept. Prom categories that are already matched won't be relinked to others. Along with the rates, the run rebuilds the automatic Rozetka and Epicentr value links; manual value links stay.

    What to do when matching didn't work

    What you seeWhyWhat to do
    The bottom table is empty no category is selected at the top, or it has no attributes click the category row; check that attributes are enabled in it
    The marketplace category list is empty the marketplace dictionary isn't loaded click “Load marketplace dictionary” (for which marketplaces)
    “The marketplace is not connected” there's no import template for this marketplace with a linked account or token create an import template, link the account or enter a token, then load the dictionary again
    Auto-matching matched almost nothing it links only exact name matches match the rest by hand, starting with the categories with the most products (order)
    Products don't reach the marketplace the marketplace category isn't matched, or there's no photo click “Publish readiness” — it gives the number of such products (about the check)
    The feed is accepted, but products are in the wrong sections the export template inserts your own ID instead of the marketplace category, or the link is wrong fix the macro in the template (where to insert) or replace the link
    “Map the categories — Elbuz fills required marketplace item specifics from product attributes with the same name…” or “Map the categories. This marketplace has no separate item-specifics mapping…” you chose a marketplace without attribute columns in the window. This isn't an error: for Allegro, eMAG, OTTO, OLX and Newegg, attributes are taken from product attributes by name; for Bol.com, TikTok and Walmart, the marketplace itself names the missing ones match the categories in the top table; check the export log for what's missing
    Attribute filters don't work on the marketplace the attributes or their values aren't matched fill in the bottom tables, including values (values)
    A wrong link you removed came back after auto-matching auto-matching fills empty rows on the same name match instead of clearing, pick the correct category right away (how)

    FAQ

    Why match categories if the feed is accepted anyway?

    Without the marketplace ID, a product ends up in a generic or random section. Shoppers search within a category, not the whole catalog, so the wrong section means lost impressions.

    Which marketplaces need attribute matching?

    Rozetka and Epicentr — attributes and their values. Cdiscount, Kaufland and Amazon — the marketplace attributes mandatory for a new listing (mandatory attributes). For the rest, categories are enough; the window says so above the attributes table.

    Where do marketplace categories come from?

    For Rozetka, Prom, Epicentr, Ceneo and Google, the dictionary is already in the program. For the other marketplaces, you load it with the “Load marketplace dictionary” button — the marketplace must be connected for that.

    Does matching create categories on the marketplace or in my catalog?

    No. It only links existing categories and publishes nothing: products are sent to the marketplace by the export template.

    Can I remove all links at once?

    No, there's no bulk action: each row is cleared separately in the “Category selection” window (how to remove a link).

    What are the Prom rates in the table?

    These are the marketplace's category-level advertising rates: a unified rate in percent and a rate for the “More sales” mode. They go into the export along with the category. Auto-matching rewrites them with values from the Prom dictionary.

    How do I link my categories to Rozetka categories so the feed is accepted?

    Directories → Categories → “Marketplace mapping”, Rozetka tab. Run auto-matching, then pick the remaining categories by hand in the “ROZETKA category” column. The ready-made Rozetka template inserts the category number into the feed (how).

    Where it is and who has access

    Menu
    Directories → Categories → the “Marketplace mapping” tile
    Other entry points
    “Categories” → tree menu → “Match categories and attributes with marketplaces”
    Access right
    the “Marketplace Category and Attribute Mapping” window in “Group permissions”
    Prepare
    the category tree and attributes; for eBay, Amazon, OLX and others — a connected marketplace
    Marketplace category and attribute matching window: category table with marketplace columns
    1Your categories next to marketplace columns
    2Marketplace category name and ID columns
    1. The top table lists your categories with the marketplace columns beside them.
    2. Each marketplace has its own category name and ID columns.

    At the very top is a row of marketplace tabs: Rozetka, Prom, Epicentr, Ceneo, Google, eBay, Amazon, Allegro, eMAG, Kaufland, Bol.com, Cdiscount, OTTO, OLX, Etsy, TikTok, Walmart, Newegg, Zalando. You work with one marketplace at a time; switching the tab changes the columns in the tables.

    Below, the window is split in two. The top shows categories: your full category path, next to it the marketplace category and its ID. The bottom shows the attributes of the category you selected above, and next to it another table with the values of the selected attribute. The hints above both blocks say it plainly: select a marketplace category to create a link; selecting a category shows a list of your attributes in that category.

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free