Elbuz gives you embed code: one configurator or a space of builds appears on your site as a block, with data and prices from the catalog, no exports.
When you need this:
- Several configurators on a “Builds” page — a space goes on the site with one code.
- Tires on one site, wheels on another — each site gets its own space and code.
- Code pasted, site still empty — allow the site's domain in the configurator card.
- The look doesn't fit your site — set custom styles and scripts in the card.
Where to start: copy the embed code and give it to whoever runs your site templates.
What it can do
- A space groups several configurators for one page of your site and lets you preview it the way a customer sees it.
- The “For widget” code goes into the template of any website, including OpenCart.
- The “For CMS module” code goes into the Elbuz module settings and shows the configurator in the page language.
- The domain list limits which sites the configurator works on.
- Your own CSS and JS fit the look to your site; AI can generate a configurator image from a description.
How to group configurators into a space
A space is a set of configurators that goes on your site as a single block. For example, a “Builds” space with the configurators “Gaming PC”, “Workstation” and “Home media center”: the customer picks a build and then goes through its steps.
The space card has three tabs: “Setup”, “Configurator list” (what the space includes) and “Integration code”. The preview button opens the space the way a customer will see it — the easiest place to check changes without touching the site.
One configurator can belong to several spaces. If you have only one build, you don't need a space: the configurator card has its own integration code.
How to delete a space
In the “Configurator groups” list, select the row, click the delete button in the toolbar and confirm. This removes the space itself, its texts and its list of configurators; the configurators stay, and this space's code on your site stops showing builds.
Which embed code to use
The “Integration code” tab of a space has one field with the code to paste on your site and a “JS, CSS settings” block. A single configurator can go on your site without a space too: in its card, on the “Setup” tab, the “Integration code” block offers the code in two forms.
| Code | What it is | Where to paste it | Language for the customer |
|---|---|---|---|
| “For widget” | a ready-made snippet | into the template of any website, including OpenCart, where the configurator should appear | main Elbuz language |
| “For CMS module” | the configurator's URL | into the Elbuz module settings on your site, not into the template | page language |
| Space code | a snippet from the “Integration code” tab | into the template of a site page | main Elbuz language |
Each field has a copy button.
The configurator won't appear on your site by itself: someone with access to the site templates has to add the integration code. Check the result in the space preview — if everything looks right there but the site shows nothing, the problem is the code placement or the domains, not the step settings.
How to allow your site's domain
The “For widget” code of a single configurator works only on allowed sites. On a site that isn't allowed, you'll see an empty space instead of the configurator.
- The domain from the “Website link” field (“Information” tab).
- Domains from the “List of domains where the widget can be placed” (“Setup” tab, next to the integration code). Enter domains without
https://and withoutwww, one per line or comma-separated — use one method for the whole list.
In the “Website link” field, www. isn't stripped: https://www.site.com allows www.site.com, but Elbuz compares the page address without www, so the check fails even if the site opens with www. So enter the “Website link” without www, or add the domain without www to the list.
The space page doesn't check the domain, but a configurator opened from the space list checks it against its own list — so your site's domain must be in the settings of every configurator in the space.
How to change the look and images
The “Integration code” tab of a space has a “JS, CSS settings” block with the “JS code” and “CSS Styles” fields.
- Styles from this field apply only to the space page — the list of configurators.
- A configurator opened from the space takes styles from the “JS, CSS settings” block in its own card, so you style the steps there.
- In “JS code”, include the
<script>…</script>tags: without them, the code is shown on the page as text.
Configurator image in a space
On the “Configurator list” tab, each row opens its own form: “Activity”, “Name” and “Description” in each language, plus an image.
- To upload your own, use the “Upload image” button.
- To generate one, click “Create image using AI”: describe what the image should show, pick an option in “Choose an image style” (“Automatic” or one of the styles) and click “Create”.
Scenarios
Tire configurators on one site, wheel configurators on another
Go to “Configurator groups” → “Add” and create two spaces. In each one, add its configurators on the “Configurator list” tab, then paste the code from each space's “Integration code” tab on its own site. Add each site's domain to the domain list of its configurators. You don't need a second store or separate categories for this.
One PC configurator on an OpenCart site
In the configurator card, on the “Setup” tab, copy the “For widget” code and paste it into the page template. Enter the site's domain without www in the “List of domains where the widget can be placed”. If the site runs the Elbuz module and you need the page language, use “For CMS module”.
What to do when the site shows nothing
| What you see | Why | What to do |
|---|---|---|
| The preview looks fine, the site shows nothing | the integration code isn't added or is in the wrong place | send the code to whoever manages the site |
| Works on the main site, empty on the second one | the second site's domain isn't in the domain list | enter the domain without https:// and www in the “List of domains…” and refresh the page |
| Empty even on the main site | the “Website link” has www | add the domain without www to the list |
| The space opens, but a build from it doesn't | the domain isn't in that configurator's settings | add the domain to the list of every configurator in the space |
| Script text shows on the page | “JS code” was entered without tags | wrap the code in <script>…</script> |
| Group names always appear in the main language | the “For widget” code or the space code is used | for the page language, install the Elbuz module and use the “For CMS module” code |
FAQ
Where do I get the code to install the configurator on an OpenCart site?
The space code is in the space card, “Integration code” tab. The code for a single configurator is in its card, “Setup” tab, “Integration code” block. More: which code to use.
My styles in the space didn't change how the steps look. Why?
Space styles apply only to the page with the list of configurators. You style the steps in the “JS, CSS settings” block of the configurator's own card.
Why use spaces if the configurator is already set up?
A space groups several configurators for one page of your site and gives you one piece of code. For a single build, the code from the configurator card is enough.
Can one configurator be in several spaces?
Yes. Add it on the “Configurator list” tab of each space, and enter the domains of all sites in its domain list.
My site opens with www. What should I enter in “Website link”?
The address without www — or add the domain without www to the “List of domains where the widget can be placed”. Otherwise the check fails. More: domains.
Where to find it and who has access
- Menu
- Directories → Categories → the “Widget settings — Configurator” tile
- Spaces
- same window → the “Configurator groups” button in the toolbar
- Code for a single configurator
- configurator card → “Setup” → the “Integration code” block
- Access right
- the “Categories” window in “Group permissions”
- Prepare
- access to your site templates, or the person who manages them
In Elbuz, the list of spaces is called “Configurator groups”: these are sets of configurators for one page of your site. Don't confuse them with step groups inside a configurator.
Related topics
- For the big picture of the configurator — Product configurator.
- If the configurator is on your site but the steps show the wrong products — How to build configurator steps.
- If your site also needs catalog search — Smart search.
