Elbuz guides the buyer through configurator steps built from your catalog categories and blocks incompatible items: a choice on one step narrows the next.
When you need this:
- No build without a CPU and motherboard — a “Required Selection” step blocks a bundle missing that item.
- Socket written as “AM4” or “Socket AM4” — a compatibility rule strips the extra word before comparing.
- Sell assembly with the build — the step's service joins the bundle with the products.
- Buyer doesn't know what to compare — step columns show key specs; AI can pick them.
Where to start: configurator card → “Structure” tab → groups and categories.
What it does
- Groups and categories define the buyer's steps and their order.
- Step options make a step required, allow several items and let the buyer set a quantity.
- Category columns show specs on the step for comparison; AI can pick them on its own.
- Category articles explain to the buyer how to choose; AI writes them from a plan.
- Category services sell assembly or setup together with the build.
- Compatibility rules narrow the choice on one step based on the choice on another.
- Price source and display limit define which price and which products the buyer sees.
How to build steps: groups and categories
The “Structure” tab has two panels: groups on the left, and categories of the selected group on the right. These are the steps the buyer goes through, in the order they appear.
| Level | What it is |
|---|---|
| Group | a logical block of the build: “Base”, “Components”, “Accessories”. Groups set the order of steps |
| Category | a specific step within a group, linked to a category of your catalog: “CPU”, “Motherboard” |
For each category, you set how the buyer goes through it:
- “Required Selection” — the bundle can't be completed without this item;
- “Recommended product selection” — the step isn't required, but the buyer is advised to complete it;
- “Multiple Selection” — the buyer can take several items (for example, several memory modules);
- “Quantity Selection” — the buyer enters how many pieces;
- “Order” and “Activity” — the step's position in the group and whether to show it at all;
- product filter — which items of the category get into the step; open it with the funnel icon in the row.
Group name in different languages
To open a group, click the pencil in its row. The group form has “Activity”, while “Name” and “Description” sit on a separate tab for each language.
- Fill in the main language.
- Switch to another language tab (for example, Russian).
- Click the translate button next to the field — “Translate from the main language value”.
The buyer's language depends on the embed code, not the page language. The “For widget” code and the space code pass the main Elbuz language. The group name appears in the site's language only via the Elbuz module in your CMS (“For CMS module”), which passes the page language. More: which embed code to use.
What to show on a step: columns, articles, services
Icons at the start of a category row open three more lists:
- “Category Columns”
- which specs to show in the step's product list, so the buyer compares what matters, not just names
- “Category Services”
- extra paid services for this step: assembly, setup, delivery
- “Category articles”
- explanatory texts inside the step: how to choose, what to look at
Category columns and AI selection
In the “Category Columns” window, besides “Add attribute” and “Add field”, there's an “Add using AI” button. It adds, in order, the ten specs that matter most to the buyer as columns.
- Candidates are only active attributes linked to this catalog category, and no more than the first 100 alphabetically. An attribute outside the first 100 by name is invisible to AI.
- Existing columns of this category in this configurator are replaced.
- If the catalog category has no linked attributes at all, the button adds nothing — link attributes to the category first.
To hide a column without deleting it, clear the “Activity” checkbox in the column's row: the column is off, the row stays, and you can turn it back on. The delete button in the toolbar removes the row for good.
Category articles: AI, order and disabling
In the “Category articles” window, the “Add using AI” button drafts an article plan for this step (the AI request asks for ten topics) and writes each article.
New articles replace the existing articles of this category, so save your edited texts separately before running it. The replacement goes beyond this configurator: article links to this category are removed in all configurators, and all blog articles lose their link to this catalog category. Before running it, write down what was linked to what.
- “Order” sets the sequence, and the “Activity” checkbox temporarily hides an article without deleting it; you edit both right in the row.
- To open an article's text, click the pencil at the start of the row.
- To link an existing blog article, click “Add” — a new row appears in the table and the “Select article” window opens; pick the article from the list.
You don't write new articles here: create them in the “Articles” window (site articles), and in “Category articles” only link an existing one.
1
Add using AI2
Order3
Activity- Add using AI — generates the plan and texts of the articles for this step and replaces the existing ones.
- Order — the sequence in which the articles are shown.
- Activity — hide an article without deleting it.
Assembly service for a category: the “Category Services” window
A service in the configurator is a product from your base catalog linked to a configurator category (step). So first create an “Assembly” product with a price in the catalog, and only then link it.
- On the “Structure” tab, in the row of the category you need, click the list icon with the “Category Services” tooltip. The “Editing - Category Services - category name” window opens.
- Click “Add” — a new row appears and product selection from the base catalog opens right away; pick the “Assembly” product.
- In the service row, you edit “Order” and “Activity” (double-click the cell); the “PID” column shows the catalog product code behind the service. The name comes from that product's card, you don't enter it separately.
1
Add2
PID- Add — creates a new row and immediately opens the product picker from the catalog.
- PID — the catalog product code behind the service.
The trash can button in the window's toolbar removes a service — only the link is deleted, the product stays in the catalog.
How to prevent incompatible builds
The “Compatibility” tab holds rules by which a choice on one step narrows the choice on another. One rule is one row with six fields. Without rules, the buyer can build anything: compatibility is up to you.
| Rule field | What it sets |
|---|---|
| “Category #1” and “Attribute #1” | the starting point: a step and its spec |
| “Operator” | how to compare: = equals, ~ contains, > greater than, < less than |
| “Category #2” and “Attribute #2” | what gets narrowed. In a “Sum” rule you can select several categories here, so one rule covers several steps; for “Comparison” and “Range” you select one category |
| “Value rule type” | comparison, sum or range |
| “Text to remove” | a word stripped from values before comparing |
| “Activity” | a disabled rule doesn't work but stays in the list |
| Rule type | How it works | Example |
|---|---|---|
| “Comparison” | attribute values must match or relate according to the chosen operator | the CPU socket equals the motherboard socket |
| “Sum” | the sum of values for the selected items is compared with the value of another | total power of the components doesn't exceed the power supply's wattage |
| “Range” | the value must fall within a range | the graphics card length fits the case dimensions |
A classic problem: one value written two ways. Half the motherboards say “AM4”, the rest “Socket AM4”, so comparison works only sometimes. No catalog cleanup needed: enter Socket in “Text to remove”, and the word is stripped from both sides before comparing. If values differ in substance, not by a word, fix them in the attribute list.
The ~ operator (“contains”) helps where values are longer than needed: the motherboard spec says “AM4, PCIe 4.0”, while the CPU just says “AM4”. Exact equality fails here, but “contains” matches.
Where the price comes from and which products to show
The “Settings” tab holds what affects the widget as a whole:
- “Price source field” — which catalog field to take the price from. This lets the configurator show not the retail price but, say, a price with a build discount.
- “Product display limit” — a filter condition on catalog fields that limits which products the configurator shows. The condition is saved with its own “Save” button below it, separately from the card; “Clear All” removes it.
Widget texts are on the “Information” tab, separately for each language: “Text after header”, “Welcome message in chat” with the macros {user_firstname}, {user_name}, {store_name}, and “Text after checkout”. Chat settings are covered in AI configurator assistant.
Scenarios
No build without a CPU and motherboard, and memory comes in several modules
On the “Structure” tab, set “Required Selection” for the CPU and motherboard categories, and “Multiple Selection” plus “Quantity Selection” for RAM. No bundle without a CPU or motherboard; on the memory step the buyer takes several items and enters the quantity. What won't happen: these options don't check that the memory fits the motherboard — that takes a “Compatibility” rule.
The catalog has the socket as “AM4” in some places and “Socket AM4” in others
On the “Compatibility” tab, add a row: “Value rule type” — “Comparison”, “Category #1” — CPUs, “Attribute #1” — socket, “Operator” — =, “Category #2” and “Attribute #2” — motherboards and their socket, “Text to remove” — Socket. Both spellings match. What won't happen: catalog spec values stay unchanged — the rule stores only its own fields.
Every PC build should offer assembly
Create an “Assembly” product with a price in the catalog. On the “Structure” tab, in the row of the step after which the service makes sense, open “Category Services” → “Add” and select this product. The service is added to the bundle together with the products; deleting the row removes only the link.
What to do when a step shows the wrong thing
| What you see | Why | What to do |
|---|---|---|
| The step is empty | the category's product filter let nothing through, or the catalog category is empty | check the filter and the category's contents |
| Compatibility doesn't work | attribute values are written differently | enter the extra word in “Text to remove” or make the values uniform in the attribute list |
| Wrong prices are shown | a different field is selected in “Price source field” | select the catalog field you need |
| Too many items on the step | no condition in “Product display limit” and the category filter is broad | set a condition and narrow the category's product filter |
| The buyer doesn't know what to compare | the category columns show the wrong specs | set up “Category Columns” |
| “Add using AI” in columns added nothing | no active attribute is linked to the catalog category | link attributes to the category and run it again |
FAQ
What's the difference between a group and a category in the structure?
A group is a logical block of the build and sets the order of steps; a category is a specific step linked to a catalog category. Groups order the steps, categories supply the products.
How do I delete a group of steps inside a configurator?
On the “Structure” tab, in the left groups panel. “Configurator groups” in the list toolbar are something else: spaces for the site; you delete them following the instructions on spaces.
Can AI write articles for a configurator category?
Yes, with the “Add using AI” button in the “Category articles” window — from there, not from the “SEO text generator”. New articles replace the existing ones, see the warning about links.
Is there a separate visibility setting for a column?
No, only the “Activity” checkbox in the column's row: when cleared, the column isn't shown and the row stays.
Is AI column selection the same as matching price list categories?
No. Here AI picks spec columns for a configurator step; price list categories are matched separately during import.
Where it is and who has access
- Menu
- Directories → Categories → “Widget settings — Configurator” tile → configurator
- Tabs
- “Structure” — steps, “Compatibility” — rules, “Settings” — price and limits
- Access right
- the “Categories” window in “Group permissions”
- Prepare
- categories, products and specs in the Elbuz catalog
Related topics
- If you need the big picture of the configurator — Product configurator.
- If the steps are ready and you want the chat assistant to recommend products from the build — AI configurator assistant.
- If the configurator is set up and it's time to put it on your site — How to add the configurator to your site.
- If specs are written inconsistently and rules don't match — Attribute list.
