↑↓ selectEnter openEsc close

    1. Elbuz

    How to create, edit and delete an attribute

    12 min readUpdated

    Elbuz creates product attributes from one name or a whole list and enables them right away in the category selected in the tree; a name already in the directory isn't created twice.

    When you need this:

    • A new category needs about fifty attributes — an Excel column becomes attributes in one go.
    • The attribute name already exists — Elbuz enables the existing one in the category, no duplicate.
    • Card attributes need blocks — attribute groups set the blocks and their order.
    • An attribute was renamed — formulas that use it update automatically.

    Where to start: select a category in the “Attributes” tree and click “Attribute”.

    What attribute creation can do

    How to create an attribute

    The “Attribute” button on the left side of the toolbar (tooltip “Add Attribute”) opens the “Adding a new attribute” dialog. It has three fields.

    • “Attribute block name” — the group the new attribute goes into. It is filled in automatically from the row selected in the table.
    • “Attribute name” — a multi-line field with the hint “Enter attribute name, e.g. Length”.
    • “Bulk create attributes” — a checkbox that lets you paste a whole list of names into the same field.

    The “Attribute block name” field is filled in automatically, but you can change it. The table selects the first row after every load, and that row's group goes into the dialog — but the field stays editable. Type a different name: Elbuz finds the group with that name, or, if there isn't one yet, creates it and puts the attribute there. You don't need to watch which row is highlighted in the table — just read what's in the field.

    Dialog «Adding a new attribute» with bulk creation enabled
    1Attribute block name
    2Attribute name
    3Bulk create attributes
    1. Attribute block name — pre-filled from the selected row and editable.
    2. Attribute name — enter one name, or several when bulk creation is on.
    3. Bulk create attributes — checkbox that lets you add many attributes at once.

    Bulk creation. Select the checkbox, paste the names, and Elbuz creates them all in one go. It picks the separator itself: whichever of line breaks, tabs and semicolons occurs most. So an Excel column works just as well as “Width; Height; Depth”. Empty lines and repeated names are dropped — one list can't produce two identical attributes.

    What a new attribute gets right after it's created:

    • Type “Text” — the default type in the type directory.
    • Filter type “Checkbox” — also the default.
    • SEO URL code — Elbuz transliterates the name into Latin characters and writes it to the “SEO URL (code)” column.
    • The export-to-website flag — if the system setting “New attributes go to the website” is on (it is on by default).
    • A name in the main language only. For other languages the description row is created empty — fill it in via “Maintenance” → “Dictionaries and translations” → “Translating attributes into other languages”.

    When creation succeeds, you see the toast “Attribute added”. An empty name shows the red line “Attribute name required!”, and the dialog stays open.

    How many names at once, and what if it breaks off. There is no numeric limit on the number of names in a list. The dialog closes right after you confirm, and the server creates the attributes in the list one by one, in a single request.

    • The “Attribute added” toast appears when the request has finished.
    • The request broke off with an error — a red toast with the error text; the attributes created before that stay in the directory.
    • You closed the window without waiting for the response — no message at all.
    • Repeating is safe: the same list creates only the missing names (what happens to a name that already exists).

    What happens if an attribute with that name already exists

    If an attribute with that name already exists, Elbuz does not create a new one. It takes the existing one and adds it to the category selected in the tree, if it wasn't there yet. The toast is the same, “Attribute added”, but no new row appears in the table.

    • The attribute is already in this category but disabled — adding it again doesn't restore the checkbox; select it manually.
    • The tree root is selected — the attribute gets only the service record “all categories”.

    The scope of the check is set by the system setting “Uniqueness includes the block” (section “Catalog” → “Attributes”). Off (the default) — the name is checked across the whole directory: only one “Width”. On — name and group are checked together, so “Width” in the “Package dimensions” group and “Width” in the “Product dimensions” group stay two separate attributes.

    A new attribute is enabled immediately in the category selected in the tree. Create it while “Refrigerators” is selected, and the “Show in product card (category)” checkbox is already selected there. A window opened from a product card works the same way — for that product's category.

    If the tree root is selected, the attribute gets only the service record “all categories”: it exists in the directory but appears on no product cards. That's why you select the category before clicking “Attribute”.

    What happens after you confirm the dialog: the main branch is whether an attribute with that name already exists. If it does, no new row appears in the table, although the toast is the same
    yesnoselectednot selectedyesnoConfirmed the “Adding a newattribute” dialogIs the “Attribute name” field empty?Red line “Attribute name required!”the dialog stays open“Bulk create attributes” checkboxThe text is split by the most frequentseparatorempty and repeated names aredroppedDoes an attribute with that namealready exist?No new attribute is createdthe existing one is linked to thecategory from the tree,if that link didn't exist yetAn attribute with the default type iscreatedname in the main language onlyThe attribute is enabled in thecategory selected in the treeat the root — only the “allcategories” recordToast “Attribute added”
    • Action or result
    • Decision: the path depends on the answer

    How to edit an attribute right in the table

    An attribute has no separate card — everything is edited in the table by double-clicking a cell. The change goes to the server immediately; there's no “Save” button here, and the whole row is saved, not just one cell. A page holds 500 rows; switch pages with the buttons under the table.

    The table has 56 columns, and they are defined by the , not by the window template. Pick the ones you need via the menu on the right → “Set up grid”. The same menu has “Refresh list” and “Clear filter”. The seven storefront filter columns are grouped under the shared header “Filter (select products by attributes)”.

    For a quick search by name, use the “Search attribute…” field on the toolbar: it matches substrings and runs about half a second after you stop typing.

    The “Attribute group name” cell moves the attribute to another group. Type “Dimensions” there, and only this one attribute moves to the “Dimensions” group; if there's no group with that name yet, Elbuz creates it. The other attributes of the old group stay where they are, and the group's own name doesn't change. Groups are not renamed here but on the “Attribute groups” tab, in the group list on the left: the new name applies to all attributes in the group at once.

    Two more columns — “Max. number of attributes” and “Max. number of values” — are set separately for each category. Select a category in the tree and enter a number: it is saved in that category's settings.

    At the tree root the number becomes shared — every category without its own value shows it. A category's own value always takes priority over the shared one.

    What happens when you delete an attribute

    The trash icon on the toolbar (tooltip “Delete Attribute”) shows a confirmation listing what will be deleted, with a red warning: “Warning! Deleting an attribute deletes all its values in all products.” If no row is selected, you see “Select a row!” instead of the confirmation.

    Deleting an attribute can't be undone. There is no Trash for attributes in Elbuz. Along with the attribute, you lose its descriptions in all languages, all links to categories, all values in products, its column in the base catalog grid, the formulas that referred to it, and its field in the export template.

    The service keeps nightly backups of the whole database for a week, but that's not an undo: restoring a backup rolls the entire database back a day — including orders, stock and edits. You start it manually: “Account” → “System settings” → “Other settings” → “Restore database backup”.

    Renaming, unlike deleting, is safe: when you change an attribute's name, Elbuz rewrites it in every formula that mentioned it through the macros {Catalog attribute: name} and {Price list attribute: name}. Formulas don't break.

    How to arrange attributes into groups on the card

    A group is a block that arranges attributes on the product card: “Main features”, “Dimensions”, “Power”. “Sort order” sets the order within a block; the group doesn't affect the values. The tab's hint says: “Groups combine attributes in the product card: the group list is on the left, the attributes of the selected group are on the right.”

    The “Attribute groups” tab is split in two. On the left is the group list with the columns “Attribute Block Name”, the “Attributes” counter, “Sort order”, “Description”, “SEO URL (code)”, “Active”, “Default” and . On the right are the attributes of the selected group.

    The “Group” button adds a new row right in the table, named “- New attribute block”; rename it by double-clicking. The trash icon next to it deletes a group. The “Attribute to group” button on the right panel adds an attribute to the selected group; if no group is selected on the left, a window pops up saying “Attribute block must be selected!”. You can move an existing attribute to another group without coming here — via the “Attribute group name” cell in the main table.

    The right side of the tab is a second grid with its own set of columns and its own bar of preset filters above it. It has fewer columns, with their own labels: “Attribute name”, “Description”, “Sort order”, “Active”, “Required”, “Product option”, “Export”, “Show in catalog grid”, “Show in product list”, “Show on product page”, “HTML editor”, “Code”, “Created automatically”, “Source”. These are the same attribute fields as on the first tab — they're just labeled differently in this grid.

    The “Attribute groups” button on the left panel opens the “Attribute blocks” window — the full list of groups with a separate edit form for each: active status, name and description in all languages, sort order. It has no categories, by design: links to categories are set on the first tab or with the “Categories” button.

    Attribute groups tab: group list on the left, attributes of the selected group on the right
    1Group
    2Attribute groups
    3Attributes counter
    4Attribute to group
    1. Group — adds a new attribute group.
    2. Attribute groups — button that links groups to categories.
    3. Attributes — number of attributes in the group (717 for Key Specifications).
    4. Attribute to group — adds an attribute to the selected group.

    Which type and filter type to choose

    The type answers two different questions, and the table has two separate columns for them. “Type” is how the value is entered and stored on the product card. “Filter type” is the control the attribute is shown as in the storefront filter. For “Screen size”, a sensible choice is the “Decimal number” type and the “Range slider” filter type.

    The type directory opens from the menu “Maintenance” → “Dictionaries and translations” → “Attribute types”. It is fixed: exactly twelve records, and the window has no “Add” button — you can't create your own types.

    The window has six columns: “Active”, “Name”, “Code”, “Default”, “Default for filter” and “Note”. Two flags are editable: “Default” and “Default for filter” — they decide which type and filter type the next new attribute gets, and each is set on exactly one type in the whole directory.

    The other columns, including “Active”, are read-only: these cells don't respond to a double-click.

    Attribute types
    NameWhat it's for
    “Text”a plain line of text. The default type — every new attribute gets it
    “Text (large field)”a long description that doesn't fit on one line
    “Number”a whole number
    “Decimal number”a fractional number
    “Date”a date
    “List”choose one value from a list
    “Checkbox”yes or no. The default filter type
    “Switch”choose one option out of several
    “Slider”a slider for a single number
    “Range slider”a “from–to” slider
    “Image”the value is shown as a picture
    “Color”a color
    Attribute types window with twelve rows
    1Text
    2Checkbox
    3Date
    1. Text — the default type.
    2. Checkbox — checkbox type.
    3. Date — the last of the twelve rows.

    Type names come from the account database, not from a language file, and the “Name” column in this window is read-only — you can't fix a label yourself. The English list is fully translated: the color type is simply called “Color”.

    In the attributes table, the “Type” and “Filter type” columns are translated into the admin interface language, while the attribute names are in the catalog data language. These are separate settings, so a “Type” column in English next to attribute names in another language is normal. The “Attribute types” window itself shows names in the data language.

    Scenarios

    A new category — you need to create fifty or so attributes from a list

    What to do. Select the category in the tree, click “Attribute”, select “Bulk create attributes” and paste the list of names into the “Attribute name” field — as a column from Excel or separated by semicolons. Correct the “Attribute block name” field if needed.

    What you get. Each name becomes an attribute with the default type and is enabled in the selected category. Empty lines and repeats in the list are dropped.

    What won't happen. Names that already exist in the directory aren't created as duplicates: Elbuz takes the existing attribute and links it to the category, if that link didn't exist yet. Names for other languages stay empty. No values appear in products.

    Attributes on the card need to be arranged into the blocks “Main”, “Dimensions”, “Power”

    What to do. On the “Attribute groups” tab, click “Group” and rename the “- New attribute block” row by double-clicking. Select the group on the left and add attributes to it with the “Attribute to group” button; set the order of the blocks in the “Sort order” column.

    What you get. The product card shows attributes in blocks, in the order of the groups.

    What won't happen. The group doesn't affect the values themselves and doesn't enable the attribute in categories.

    What to do when an attribute wasn't created or ended up in the wrong place

    Troubleshooting common problems
    What you seeWhyWhat to do
    You created an attribute, but it isn't checked in any category The tree root was selected when it was created: the attribute got only the service record “all categories” Go to the category you need and select the checkbox yourself; next time, select the category in the tree before clicking “Attribute” (how to create an attribute)
    “Attribute added”, but there's no new row in the table An attribute with that name already existed: Elbuz doesn't create a duplicate but takes the existing one Find the existing attribute with search and select its checkbox in the category you need (the same name can't be created twice)
    The new attribute went into the wrong group The “Attribute block name” field was filled in from the selected table row and left as it was Type the right group name in the “Attribute group name” cell — the attribute moves there; next time, correct the field right in the dialog (how to create an attribute)
    You edited “Attribute group name”, and the attribute disappeared from its group This cell moves the attribute to the group with the name you entered; if there was no such group, it has just been created Type the old name back into the same cell — the attribute returns. Remove an empty group created by mistake with the trash icon on the “Attribute groups” tab; that's also where groups are renamed (attribute groups)
    “Attribute block must be selected!” You clicked “Attribute to group” on the “Attribute groups” tab without selecting a group on the left Select a group in the left panel and try again (attribute groups)
    “Attribute name required!” The “Attribute name” field is empty; the dialog doesn't close Enter a name. To add several at once, select “Bulk create attributes” (how to create an attribute)
    “Select a row!” You clicked the trash icon without selecting a row Click a row in the table and try again
    “Set value” — it's unclear what exactly the command will affect The command writes a value into the chosen column of the selected row: the result is the same as double-clicking the cell, except you type in a dialog Before using it, make sure the right attribute and the right column are selected: there's no list of affected records here, and no undo
    “Do you want to clear the values in the selected field?” The value was left empty in the bulk set-value dialog Confirm only if you really want to clear this field for the selected attribute

    FAQ

    What's the difference between “Type” and “Filter type”?

    “Type” is how the value is entered and stored on the product card. “Filter type” is the control the attribute is shown as in the storefront filter. For “Screen size”, a sensible choice is the “Decimal number” type and the “Range slider” filter type (types).

    How do I make new attributes get the “List” type and go straight into the filter?

    Type and filter type — yes: the “Default” and “Default for filter” flags in the “Attribute types” window. The filter — no: “Display in filter” is turned on in categories manually or with AI (storefront filter).

    Can I create my own attribute type?

    No. The type directory is fixed — twelve records, with no “Add” button (types).

    Can I restore a deleted attribute?

    No: there's no Trash for attributes, and the values in products are deleted along with it. A backup rolls the entire database back a day, including orders (deletion).

    How do I move an attribute to another group?

    Type the group name in the “Attribute group name” cell of its row — only this attribute moves. Groups are renamed on the “Attribute groups” tab (editing in the table).

    Where to find it and who has access

    Menu
    Directories → Base product catalog → Attributes → the “Attribute” button
    Groups
    the same window, the “Attribute groups” tab
    Types
    in the “Attributes” window: “Maintenance” → “Dictionaries and translations” → “Attribute types”
    Access right
    the “Attributes” window in group permissions
    Prepare
    a category in the tree — the new attribute is enabled in that category

    How the directory works, and which attribute settings are shared and which are set per category, is covered in How to add an attribute to the product card.

    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