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
- Manual matching — you pick the marketplace category, attribute and value in a cell, and it is saved right away.
- Nineteen marketplaces in one window — from Rozetka and Prom to eBay, Amazon, OTTO and Newegg.
- Separate matching for each country on eBay, Amazon and eMAG.
- Mandatory attributes for Cdiscount, Kaufland and Amazon — without them a new listing won't go to the marketplace.
- Auto-matching covers exact name matches and leaves manual links alone.
- Replacing a wrong link — in the row's “Category selection” window.
- Publish readiness — how many products you can send and why the rest won't go.
- Marketplace codes in the export — the template picks them up with macros.
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”.
| Marketplace | What gets matched |
|---|---|
| Rozetka, Epicentr | categories and attributes together with their values |
| Prom | categories; the “Unified rate, %” and the rate for “More sales” are set separately |
| Cdiscount, Kaufland | categories and category attributes marked as mandatory or not |
| Amazon | product type and the type's mandatory attributes — separately for each Amazon marketplace |
| eBay, eMAG | categories — separately for each eBay site or eMAG country; eMAG attributes come from product attributes with the same name |
| OTTO, Newegg, Allegro, OLX | categories (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, TikTok | categories; the marketplace names any missing mandatory attributes in its response to the publication |
| Ceneo, Google | categories |
| Walmart, Zalando | Walmart 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.
- 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:
| Tab | What you choose in the list | What changes |
|---|---|---|
| eBay | one of 19 sites: eBay Germany, Poland, USA, UK, France, Italy and others | the eBay category for that site |
| Amazon | marketplace: Amazon.de, Amazon.fr, Amazon.it… | the product type and mandatory attributes for that marketplace |
| eMAG | eMAG.ro, eMAG.bg, eMAG.hu, eMAG.pl | the 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.
- Match the category (for Amazon, the product type of the selected marketplace).
- Click the category row — your attributes appear below.
- 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.
1
Zalando chip2
Zalando attribute column header- The Zalando chip switches the window to Zalando mapping.
- The Zalando attribute column header in the attribute table.
1
Cdiscount chip2
Cdiscount attribute column header- The Cdiscount chip is active.
- 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
- Find your category in the top table.
- Switch to the marketplace tab you need and pick its category from the list in the cell. The link is saved right away.
- 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.
- 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
- Load the marketplace dictionary if it is loadable (all marketplaces except Rozetka, Prom, Epicentr, Ceneo and Google).
- Run auto-matching — it covers categories whose names match exactly.
- Check the categories with the most products by hand.
- Click “Publish readiness” and see how much is left.
- 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).
- 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:
- In the category row, click the arrow next to the marketplace category name — the “Category selection” window opens.
- 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.
- Or pick the correct category right away and click “Select” — the link is replaced.
1
Arrow in the category row2
Marketplace category field3
Select button- The arrow next to the marketplace category opens the selection window.
- The field is where the marketplace category is chosen.
- 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.
| Marketplace | Where 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, XML | same 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 see | Why | What 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
1
Your categories next to marketplace columns2
Marketplace category name and ID columns- The top table lists your categories with the marketplace columns beside them.
- 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
- If matching is done and you need to send products to Rozetka — Exporting the catalog to Rozetka.
- If products go to Epicentr — Exporting the catalog to Epicentr.
- If a category lacks the attributes you need — Attribute directory.
- If “Publish readiness” shows products without photos — Product photos.
- If you plan to sell on marketplaces — what it gives your store.
