↑↓ selectEnter openEsc close

    1. Elbuz

    How to add a configurator to your website: spaces, code and domains

    3 min readUpdated

    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.

    CodeWhat it isWhere to paste itLanguage for the customer
    “For widget”a ready-made snippetinto the template of any website, including OpenCart, where the configurator should appearmain Elbuz language
    “For CMS module”the configurator's URLinto the Elbuz module settings on your site, not into the templatepage language
    Space codea snippet from the “Integration code” tabinto the template of a site pagemain 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 without www, 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 seeWhyWhat to do
    The preview looks fine, the site shows nothingthe integration code isn't added or is in the wrong placesend the code to whoever manages the site
    Works on the main site, empty on the second onethe second site's domain isn't in the domain listenter the domain without https:// and www in the “List of domains…” and refresh the page
    Empty even on the main sitethe “Website link” has wwwadd the domain without www to the list
    The space opens, but a build from it doesn'tthe domain isn't in that configurator's settingsadd the domain to the list of every configurator in the space
    Script text shows on the page“JS code” was entered without tagswrap the code in <script>…</script>
    Group names always appear in the main languagethe “For widget” code or the space code is usedfor 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

    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