↑↓ selectEnter openEsc close

    1. Elbuz

    How to add an attribute to the product card

    15 min readUpdated

    Elbuz keeps product attributes in one attribute directory and enables each where needed: one checkbox puts the field on the cards of all the category's products.

    When you need this:

    • A marketplace needs an attribute the card lacks — find it and enable it in the product's category.
    • An attribute is needed in twenty categories — the “Categories” button enables it in one list.
    • Products come from price lists and imports — Elbuz enables attributes that have values.
    • Filters and field order differ by category — each category has its own settings.

    Where to start: in the “Attributes” window tree, select a category and tick “Show in product (category) card”.

    What the attribute directory does

    The table shows the whole directory, not the category's attributes

    The table always shows the entire directory, however many attributes it holds. Selecting a category in the tree doesn't filter the list. You select “Smartphone” and see thousands of rows, but they aren't thousands of smartphone attributes.

    In the demo account, with the “Smartphone” category selected, the table shows over three thousand rows, and only 155 of them have the checkbox linking them to this category. The rest have nothing to do with smartphones.

    So what does selecting a category do? Exactly two things:

    1. The first checkbox column appears: “Show in product (category) card”. While the tree root (the entire catalog) is selected, this column isn't there at all — there's nothing to enable it in. The line above the table then reads: “All catalog attributes — select a category on the left to work with its set”.
    2. Some columns start showing this category's values instead of the shared ones. “Sort order”, “Required”, “Display in filter” and a few others are set per category. The other columns are shared across Elbuz, and editing them in any category changes them everywhere.

    You don't need to search for the selected category's set: Elbuz puts it at the top of the table and grays out the names of all other attributes — those not enabled in this category. A gray name and an empty checkbox mean the same thing.

    A gray name only refers to the current category: an attribute enabled nowhere looks the same as one not enabled just here.

    To know which mode you're in, look at the line above the table: it shows either the full name of the selected category or the phrase about the whole catalog. Right after the window first opens, the line is empty — click any category in the tree or the tree root, and it appears.

    Attributes window with the Smartphone category selected
    1Category tree
    2Selected category path
    3Show in product card (category) column
    4Search attribute
    5Categories button
    1. Category tree — pick a category to see its attributes.
    2. Full path of the selected category (Gadgets / Smartphone).
    3. First column: tick marks attributes shown in the product card of this category.
    4. Search field for finding an attribute by name.
    5. Categories button — opens the attribute-to-category link window.

    What applies everywhere and what applies only to this category

    An attribute is created once and exists as one record. It isn't copied into a category — it's enabled there. So some settings live on the attribute and apply everywhere, and some on its link to a category. The interface doesn't show this boundary: both kinds of columns sit side by side. Here it is as a table.

    Where each column is actually stored
    ColumnApplies
    “Attribute name”, “Short name”, “Attribute description”, “Value suffix”shared, separately for each data language
    “Type”, “Filter type”, “Unit of measure”, “SEO URL (code)”shared
    “Active”, “Product option”, “Export to site (file)”, “Display on site in product card”, “Show on site in product listing”, “Show in base catalog grid”, “Read-only”, “Multiline values”, “Display HTML editor”, “Value list expanded”shared — change it while in one category and it changes in all of them
    “Show in product (category) card”this category only
    “Sort order”this category only; with no category selected — shared
    “Required”this category only; with no category selected — shared
    “Display in filter”this category only
    “Display horizontally”this category only; with no category selected — shared
    “Use to create variable products”this category only; with no category selected — shared
    “Use for brief description”, “Sort order in brief description”this category only
    “Rozetka ID”, “Rozetka name”in this category if set; otherwise the shared value is used

    The last row is about with marketplaces. The table has “Rozetka ID”, “Rozetka name”, “Epicentr ID”, “Epicentr code” and “Epicentr name” columns. Don't edit them here: they're filled in a separate marketplace matching window for categories and attributes.

    The Epicentr columns are shared by all categories: a code entered with a category selected changes for the attribute everywhere.

    A real example from the demo account. The “GPU manufacturer” attribute is enabled in three categories, and it's configured differently in each:

    Category“Sort order”“Display in filter”
    Graphics card10on
    Prebuilt PC0on
    Laptop150off

    One attribute, three different behaviors. In graphics cards its order is 10 and it works as a filter; in laptops its order is 150 and it isn't in the filter. That's exactly what “category settings” means.

    “Active” is shared. If you clear this checkbox while in any category, you disable the attribute across the whole catalog at once. To remove an attribute from one category, clear “Show in product (category) card”, not “Active”.

    In practice, this means: when no category is selected in the tree, “Sort order”, “Required”, “Display horizontally” and “Use to create variable products” are edited globally — on the attribute itself. For “Required”, this has a consequence worth knowing in advance.

    “Required” with no category selected makes the attribute required for the whole catalog. Elbuz adds such an attribute as an empty row to every product, regardless of category — and every product immediately counts as incomplete. If the attribute is required only for refrigerators, first select “Refrigerators” in the tree, and only then tick the checkbox.

    From a row in the directory to a field on the product card and a storefront filter
    not tickedtickedtickednot tickedAttribute in the directory: name,type, display rules“Show in product (category) card”checkboxThe attribute is in the directory,but the category's products don'thave itElbuz creates empty attribute rowsfor the products in this categoryThe field appears on the “Attributes”tab of the product cardA manager enters the valueThe attribute on the product page ofthe site“Display in filter” checkboxShoppers can find the productwith a storefront filterThe storefront filterdoesn't have this attribute
    • Action or result
    • Decision: the path depends on the answer

    Next, read the section that matches your case.

    How to set the order of attributes on the product card

    You set a category's order in this same window: select the category in the tree and enter numbers in the “Sort order” column — a lower number goes higher. No column? Turn it on with the grid configuration button. The “Display attribute by category” window (the “Categories” button) has no order column, only link and filter checkboxes.

    The product card sorts attributes by several keys in turn, and the category order isn't the first of them:

    1. attribute groups — by the order of the groups themselves on the “Attribute groups” tab; an attribute from the “Dimensions” group won't rise above the “General” group, whatever order you give it;
    2. within a group — the value's own order in the product, if an import brought one (the attribute order in the file or on the supplier's site);
    3. next — “Sort order” in the product's main category;
    4. next — the attribute's shared “Sort order”, the one you see with no category selected;
    5. last — the name, alphabetically.

    This answers “why does the order differ between the general list and the category”. They're two different numbers. An attribute enabled in a category starts there at zero; the shared order isn't copied. While all of the category's attributes are at zero, the card uses the shared order; once you set numbers in the category, they take priority.

    The stats bar: five numbers above the table

    There are five tiles above the table. They're recalculated every time you select a category in the tree, and they show different things depending on whether a category is selected.

    TileNo category selectedCategory selected
    “Total attributes”all attributes in the directoryhow many of them are enabled in this category
    “Active”attributes with “Active” tickedthe same among the category's attributes
    “Groups”all attribute groupshow many different groups appear in this category
    “In filters”attributes with “Display in filter” set in at least one link recordmarked for the filter in this specific category
    “Unused”attributes no product has — not a single row, not even an empty one; synonyms and main synonyms aren't countedthe category's attributes that no product in this category has
    Statistics strip above the attributes table
    1Total attributes
    2In filters
    3Unused
    1. Total attributes — all attributes available for the selected category.
    2. In filters — attributes used as storefront filters.
    3. Unused — attributes not used by any product; the tile was not clicked.

    The last tile is the only clickable one: it opens the “Unused attributes” window, where you can review them before deleting. When the number is above zero, the tile is highlighted in a warning color.

    • With no category selected, the number on the tile equals the number of rows in the window — both count by the same rule and both leave out synonyms and main synonyms.
    • With a category selected, the tile and the window show different things: the tile counts this category's attributes missing from its products, while the window always shows the whole directory. To compare the numbers, select the tree root.

    This tile shows how cluttered the directory has become: how many attributes no product uses. Such attributes appear on their own — price lists, parsers and imports add to the directory, and nobody cleans up. Each of them then shows up in selection lists, column settings and marketplace matching.

    How to enable an attribute in a category

    This is the checkbox people come to this window for. The column is called “Show in product (category) card”, and it's the first one in the table.

    1. Select a category in the tree on the left. Until you do, the checkbox column isn't there.
    2. Find the attribute in the table using the “Search attribute…” field.
    3. Double-click to tick the checkbox.

    The tree controls the table, however you got to the window. Opened from the category card, the window starts on that category, but switching to another branch moves everything there: the caption above the table, the tiles, the checkbox and the category columns. So you can go through several categories without closing the window.

    The exception is the window opened from the product card: there's no tree there, just one category (see the separate section).

    What happens at that moment: Elbuz saves the link “this attribute ↔ this category” and, if the window was opened from the product card, immediately creates empty attribute rows for the product — the field appears on its card. For the category's other products, empty fields are added when their card is opened.

    How the tree works:

    • the selected category is remembered in the browser — next time the window opens on it;
    • you search the tree with the “Enter category name” field, and search starts at two characters — with one letter it does nothing;
    • search finds categories in collapsed branches too, but expands only the path to the match;
    • the panel menu has “Expand all categories”, “Collapse all categories”, “Refresh list”, “Clear filter”;
    • you can drag the panel width with the mouse, and double-clicking its edge collapses it completely.

    Many categories at once: the “Categories” button

    Ticking one category at a time takes too long when an attribute is needed in twenty. Select the attribute in the table and click the “Categories” button in the toolbar (the same item is in the row's context menu). The “Display attribute by category” window opens with the attribute's name in the title.

    Inside is a flat list of all catalog categories with full names and three columns: “Category name”, “Link” and “Display in filter”. The hint at the top reads: “Tick the categories in which you want to display the attribute.” Double-click to edit; changes are saved immediately.

    The very first row is “All Categories”. It isn't “select all”: a checkbox in this row doesn't make the attribute visible in categories without their own checkbox. The row sets the default for the filter and brief description flags, and also serves as the link for products with no category.

    Display attribute by category window for the Memory Type attribute
    1All Categories row
    2Link column
    3Display in filter column
    1. All Categories — the first row applies to every category.
    2. Link — ticks where the attribute is linked to the category.
    3. Display in filter — ticks where the attribute is shown in the storefront filter.

    Clearing the “Link” checkbox doesn't erase the category's settings — the record stays, just disabled. The order, required status and filter flag you once set for this category are kept, and everything comes back when you enable it again.

    Where attributes come from

    An average store's directory has thousands of attributes, not a hundred, and nobody typed them in by hand. Here are all five sources they come from.

    1. Manually on the product card. The card's “Attributes” tab — that's where you enter a specific product's values.
    2. From supplier price list fields. A price list column is marked as an attribute, and its values are distributed to products during loading; such attributes have the “Source ID”, “Source - code” and “Source - name” columns filled. More: How to turn price list columns into product attributes.
    3. By file import. , CML (1C), Prom-XLS, the site tunnel — each format writes attributes directly.
    4. By site parsing. Attributes with no match get their own review window.
    5. By AI. The “Create attributes for the category” item in the “AI tools” menu (AI and product attributes).

    The sources overlap, and that's what the “Read-only (value is never removed automatically)” checkbox is for: a value entered by a person won't be overwritten by a or by a base catalog update.

    Two more toolbar menus:

    • “AI tools” — besides creating attributes, it checks values for duplicates, finds duplicate attributes, and in the “Automatic analysis” group picks attributes for filters and the brief description (AI and product attributes).
    • “Maintenance” → “Dictionaries and translations” — attribute types, attribute translation into other languages, bulk “Translate into other languages”.
    • “Maintenance” → “Cleanup” — attribute matching, value replacement rules, unused attributes, updating value s.
    • “Maintenance” → “Danger zone” in red — deleting duplicates, attributes with no values, and the whole directory together with the values in products. These commands can't be undone.

    Elbuz can link attributes on its own

    If attributes arrive from price lists and files, you don't tick checkboxes by hand. Elbuz takes every “attribute ↔ product category” pair that has a non-empty value and enables the link itself — after a YML, CML or Prom-XLS import, the site tunnel, parsing, a price list load, and when a product is saved.

    One system setting controls this — “Distribute across categories” in the “Catalog” → “Attributes” section. It's on by default, which is why links appear on their own almost everywhere. Manual settings aren't lost: before linking, Elbuz remembers the order, required status, filter flag and Rozetka mappings, and restores them at the end.

    Automatic linking adds only the “attribute ↔ category” pairs that don't exist in the directory at all. A pair whose “Show in product (category) card” checkbox you cleared manually stays disabled — automatic linking doesn't turn it back on.

    An interruption in the middle of this step breaks nothing: links added before it stay, and the next import or product save adds the rest without creating any pair twice.

    Almost all “attribute ↔ category” links are set this way, automatically. At the same time, some attributes aren't enabled in any category — they exist in the directory and nobody sees them.

    Test it on one product

    The quickest way to make sure you understand how it works before ticking checkboxes across the whole catalog.

    Test it on one product

    Reopening the card isn't a formality. The “Attributes” tab loads its content once, when the card opens, and that's when Elbuz adds empty rows for new links. A card that stayed open won't show the field.

    The exception is when you came to the directory with the “Attribute setup” button from the card itself: empty rows are created right away there, and closing the directory window is enough.

    Still no field? Check two things:

    • whether the product really is in the category you ticked (the full name is shown in the base catalog grid);
    • whether a different category is selected in the tree — the checkbox belongs to the one whose full path is shown above the table.

    “Active” has nothing to do with it: it removes the attribute from the catalog grid, from field selection lists and from completeness counts, but doesn't hide the field on the product card.

    Scenarios

    The labels below are from the “Attributes” window: the category tree on the left, the directory table on the right, the toolbar above the table.

    A marketplace requires an attribute missing from the cards of a whole category

    What to do. Select the category of these products in the tree. If the attribute is already in the directory, find it with “Search attribute…” and tick “Show in product (category) card”. If it isn't, click “Attribute” and create it without leaving the category: a new attribute is enabled in the category selected in the tree.

    What you get. Every product in this category gets an empty attribute field — at the moment its card is opened.

    What won't happen. Values won't fill themselves: you enter them on the product card or bring them in with a price list or import. Products in other categories won't get the field. A card that stayed open won't show the field until you reopen it.

    An attribute must be required in only one category

    What to do. First select that category in the tree, then tick “Required” in the attribute's row.

    What you get. The required status is saved on the link between the attribute and this category.

    What won't happen. Other categories won't become incomplete — as long as you ticked the checkbox with the category selected. The same checkbox at the tree root is written to the attribute itself and applies to the whole catalog.

    An attribute is needed in many categories at once

    What to do. Select the attribute in the table, click “Categories” and tick “Link” in the categories you need; “Display in filter” is there too.

    What you get. The attribute is enabled in the ticked categories; changes are saved immediately (the “Categories” button).

    What won't happen. The “All Categories” row doesn't enable the attribute everywhere — it only sets the default value.

    What to do when an attribute is missing

    Common problems
    What you seeWhyWhat to do
    The attribute is in the directory, but the product card has no field for it “Show in product (category) card” isn't ticked for this product's category Select the product's category in the tree and tick the checkbox, or tick the categories you need in a list with the “Categories” button (how to enable an attribute)
    You cleared “Active” in one category and the attribute disappeared from all of them “Active” is a shared attribute setting, not a category one Tick it again. To remove an attribute from one category, clear “Show in product (category) card” (what's shared and what isn't)
    You changed “Sort order” in one category, but another category still has the old one That's by design: “Sort order” is stored separately in each category Set the order in each category, or deselect the category (tree root) — then you edit the shared value (what's shared and what isn't)
    After one checkbox, every product in the catalog became incomplete “Required” was ticked with no category selected, so the attribute became required for the whole catalog Clear the checkbox with no category selected, then select the category you need and tick it there (what's shared and what isn't)
    The table has no first checkbox column The tree root (the entire catalog) is selected: there's nothing to enable the attribute in, so the column is hidden Click the product's category in the tree — the column appears, and the category's full path shows above the table (how to enable an attribute)
    The checkbox is ticked, but the product card that was already open has no field The card's “Attributes” tab loads once when the card opens; switching sections doesn't reload it Close the card and open it again (test it on one product)
    Searching the category tree does nothing Only one character was entered — search starts at two Enter at least two characters (how to enable an attribute)
    “There was a problem!” and technical text in a window The grid couldn't get data from the server Refresh the table from the menu → “Refresh list”. If it happens again, contact support and attach the text from the window
    Instead of the window, an image about restricted access, with no explanation Your group doesn't have the right to the “Attributes” window Ask the account owner to grant access to the “Attributes” window in the catalog module (who has access)

    FAQ

    Why is the attribute I need missing from the product card?

    It isn't enabled for this product's category. In the “Attributes” window, select the product's category in the tree, find the attribute by search and tick “Show in product (category) card” (how to enable it).

    Why does the table show thousands of attributes when I selected one category?

    The table always shows the whole directory. The selected category's set is at the top of the table, and the names of all other attributes are gray (why).

    I changed an attribute setting in one category — why did it change everywhere?

    You changed a shared setting: the name, type, “Active” and the site display flags apply across Elbuz. Only a few columns are set per category (table).

    Why is the attribute order different in the general list and in the category?

    They're two separate numbers. With no category selected, “Sort order” is shared; with one selected, it's the category's own, and that one takes priority. An attribute newly enabled in a category starts at zero (order on the card).

    Why is an attribute in the list shown in pale gray?

    A gray name means the attribute isn't enabled in the category selected on the left. Green means a synonym of another attribute; blue means a main attribute with synonyms (synonyms).

    Where do I enter an attribute value?

    On the product card, in the “Attributes” section. The directory defines which fields exist and in which categories they appear; values come from the card, price lists and imports (where they come from).

    Can I see how many products have an attribute filled in?

    The directory table has no such column. The “Values” tab has a “Products” counter for each individual value, and the “Unused attributes” window shows attributes with no products at all (the stats bar).

    Where to find it and who has access

    Menu
    Directories → Base product catalog → Attributes
    From the category card
    the “Tools” section → the “Attribute setup” tile
    From the product card
    the “Attributes” section → the “Attribute setup” button
    From “Product details”
    an expanded row in the grid, the same button
    Access right
    the “Attributes” window — one right covers the window and all its child windows
    Prepare
    the catalog's category tree — an attribute is enabled in a specific category

    Opened from the menu, the window shows the whole directory; from the category card, it opens on that category; from the product card, it shows one category and no tree (see the separate section). There's no desktop shortcut by default, but you can drag one out yourself.

    Left menu with the Directories > Base product catalog branch expanded
    1Attributes menu item
    1. Attributes — opens the attribute directory window.

    The window has three tabs: “Attributes” is the directory itself; “Attribute groups” are the blocks that arrange attributes on the product card (attribute groups); “Values” lists every value of the selected attribute and lets you fix them in many products at once. The tree sets the scope: a category means its products, the root means the whole catalog.

    Anyone who can open “Attributes” can also open all its child windows — “Display attribute by category”, “Attribute types”, “Unused attributes”, synonyms — and the “Danger zone” menu, which deletes the entire directory. Without the right, you see an image about restricted access instead of the window, with no text.

    Group permissions also control which columns the main table and the “Attribute groups” table show: a column can be shown read-only or hidden. No module is required — every account has the window.

    The same window opened from the product card

    When you open the window with the “Attribute setup” button in the “Attributes” section of the product card, it looks different, and that's by design:

    • no tabs — just the directory, without “Attribute groups” and “Values”;
    • no category tree — there's only one category, the product's own, and its full name is shown in a line above the table;
    • the “?” button moves from the tree header to the toolbar;
    • the first column doesn't narrow the table here either: the whole directory is shown, there's just one checkbox, and it belongs to this product's category;
    • the checkbox works fully: along with the link, Elbuz creates empty attribute rows for this product, and the field appears on its card right away.

    The reason is simple: with a tree, the window would hold two different contexts — the checkboxes would belong to the product's category, while the tools and the “Values” tab would look at the category selected in the tree. That's why there's no tree here.

    The hint line below the table — “To show an attribute on the product card, tick the checkbox in the “Show on product card (category)” column.” — appears in both cases when the window opens with a category already set: from the product card and from the category card.

    Values are entered on the product card itself.

    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