Your configurator on any website
A few lines of code or one plugin. Pick your platform and follow the steps; it usually takes less than ten minutes.
The three forms of the code
<div data-voncon-configurator="your-configurator" data-voncon-key="pk_live_YOUR_KEY" data-voncon-locale="en"></div>
<script src="https://app.voncon.app/sdk/v1.js" defer></script><iframe src="https://app.voncon.app/embed/your-configurator?key=pk_live_YOUR_KEY&locale=en"
style="width:100%;height:1100px;border:0" loading="lazy" title="Configurator"></iframe>[voncon configurator="your-configurator" key="pk_live_YOUR_KEY" locale="en"]WordPress
Use the VONCON plugin and a shortcode, or paste the script into a Custom HTML block.
- 1In VONCON open “Website embed” and download the WordPress plugin (voncon-wordpress.zip).
- 2In WordPress go to Plugins → Add New → Upload Plugin, choose the zip and activate it.
- 3Edit the page, add a Shortcode block and paste the shortcode from VONCON.
- 4Without the plugin: add a Custom HTML block and paste the script code instead.
- 5Publish and open the page: the configurator appears in your colours.
Page builders (Elementor, Divi, WPBakery) have their own HTML or shortcode widget; both forms work there too.
[voncon configurator="your-configurator" key="pk_live_YOUR_KEY" locale="en"]Shopify
Add a Custom Liquid section to the page or product template.
- 1Add yourshop.myshopify.com and your own domain to the key’s allowed domains.
- 2In Shopify open Online Store → Themes → Customize.
- 3Open the page or product template, click Add section and choose Custom Liquid.
- 4Paste the script code into the Liquid field and save.
- 5Preview the page; the configurator loads below the section above it.
Older themes without sections: paste the code into the page content using the “Show HTML” (<>) button.
<div data-voncon-configurator="your-configurator" data-voncon-key="pk_live_YOUR_KEY" data-voncon-locale="en"></div>
<script src="https://app.voncon.app/sdk/v1.js" defer></script>Wix
Use “Embed a site” with the configurator’s address, so it runs on your domain.
- 1Copy the iFrame code in VONCON and take the address from its src="…" part.
- 2In the Wix editor click Add Elements → Embed Code → Embed a site.
- 3Click Enter Website Address, paste the address and apply.
- 4Drag the frame to full width and give it a height of about 900 px (1100 px on mobile).
- 5Publish. Your Wix domain must be in the key’s allowed domains.
Wix places “Embed HTML” code on its own helper domain; “Embed a site” avoids that and is the more reliable choice.
<iframe src="https://app.voncon.app/embed/your-configurator?key=pk_live_YOUR_KEY&locale=en"
style="width:100%;height:1100px;border:0" loading="lazy" title="Configurator"></iframe>Webflow
Drop an Embed element where the configurator should appear.
- 1Add yoursite.webflow.io and your own domain to the allowed domains.
- 2In the Designer open Add (+) → Components → Embed and drop it into the section.
- 3Paste the script code and save and close.
- 4Set the parent section to full width; the configurator sizes itself.
- 5Publish the site; the preview inside the Designer does not run scripts.
<div data-voncon-configurator="your-configurator" data-voncon-key="pk_live_YOUR_KEY" data-voncon-locale="en"></div>
<script src="https://app.voncon.app/sdk/v1.js" defer></script>Squarespace
Add a Code block to the page.
- 1Add your Squarespace domain and your own domain to the allowed domains.
- 2Edit the page, click Add Block and choose Code.
- 3Paste the script code, leave the mode on HTML and turn “Display source” off.
- 4Save and leave the editor: code blocks run only on the live page.
Code blocks need a Business plan or higher. On lower plans use the iFrame code in an Embed block.
<div data-voncon-configurator="your-configurator" data-voncon-key="pk_live_YOUR_KEY" data-voncon-locale="en"></div>
<script src="https://app.voncon.app/sdk/v1.js" defer></script>Joomla
Use a Custom module or an article with the editor in code view.
- 1In Joomla open Content → Site Modules → New → Custom.
- 2Switch the editor to code view (Toggle Editor) and paste the script code.
- 3Assign the module to a position and to the menu item of your configurator page, then save.
- 4If the editor removes the script, allow it under System → Global Configuration → Text Filters, or use the iFrame code.
<div data-voncon-configurator="your-configurator" data-voncon-key="pk_live_YOUR_KEY" data-voncon-locale="en"></div>
<script src="https://app.voncon.app/sdk/v1.js" defer></script>Google Sites
Google Sites accepts the iFrame address as an embed.
- 1Add sites.google.com and googleusercontent.com to the key’s allowed domains.
- 2In Google Sites click Insert → Embed → Embed code and paste the iFrame code.
- 3Resize the box to the full width and about 1100 px high.
- 4Publish the site.
<iframe src="https://app.voncon.app/embed/your-configurator?key=pk_live_YOUR_KEY&locale=en"
style="width:100%;height:1100px;border:0" loading="lazy" title="Configurator"></iframe>HTML / iFrame
Any page you can edit: paste the code where the configurator should appear.
- 1Paste the script code into the page’s HTML, inside the content area.
- 2The script loads once and fills every element with data-voncon-configurator on the page.
- 3Where scripts are not allowed, use the iFrame code with a fixed height (about 1100 px).
- 4Upload the page and open it on a domain from the allowed list.
Optional attributes: data-voncon-locale="de" for the language, data-voncon-height="900" for a starting height.
<div data-voncon-configurator="your-configurator" data-voncon-key="pk_live_YOUR_KEY" data-voncon-locale="en"></div>
<script src="https://app.voncon.app/sdk/v1.js" defer></script>React / Next.js
Load the script once and mount the configurator in a component.
- 1Load https://app.voncon.app/sdk/v1.js once (in Next.js with next/script).
- 2In a component, call window.Voncon.mount(element, { key, configurator, locale }) in an effect.
- 3Keep the returned object: on("price", …), on("lead", …) and openQuoteRequest() connect it to your page.
- 4Call destroy() when the component unmounts.
With a Content Security Policy, allow app.voncon.app in script-src and frame-src.
'use client';
import Script from 'next/script';
import { useEffect, useRef } from 'react';
export function Configurator() {
const el = useRef<HTMLDivElement>(null);
useEffect(() => {
let c: { destroy(): void } | undefined;
const mount = () => {
c = window.Voncon.mount(el.current!, {
key: 'pk_live_YOUR_KEY',
configurator: 'your-configurator',
locale: 'en',
});
};
if (window.Voncon) mount();
else window.addEventListener('voncon:ready', mount, { once: true });
return () => c?.destroy();
}, []);
return (
<>
<Script src="https://app.voncon.app/sdk/v1.js" onLoad={() => window.dispatchEvent(new Event('voncon:ready'))} />
<div ref={el} />
</>
);
}Full-screen configurator
A link instead of a frame: your product in a real room, 3D, drawing and AR on the whole screen.
- 1Take the iFrame address from VONCON and add &mode=immersive.
- 2Add &back= with the address of your page (URL-encoded), so the configurator shows a way back.
- 3Put the address behind any button, e.g. “Configure live”.
- 4Optional: &values= with starting values as JSON, and &locale= for the language.
The page behind back must be on one of the key’s allowed domains, otherwise the back button is hidden.
<a href="https://app.voncon.app/embed/your-configurator?key=pk_live_YOUR_KEY&locale=en&mode=immersive&back=https%3A%2F%2Fyourcompany.com%2Fwindows">
Configure live
</a>Configurator switcher
Let customers move between your configurators (window, door, garage door) without leaving the page.
- 1Add &switch=1 to offer all published configurators the key may open.
- 2Or list the ones you want: &switch=window-pvc,entrance-door.
- 3The configurator’s name at the top then opens a menu with the others.
https://app.voncon.app/embed/your-configurator?key=pk_live_YOUR_KEY&mode=immersive&switch=1Stuck somewhere?Send us the address of your page and we will help: voncon@vonito.ba