embedding
Embedding: the configurator in one line of code
The configurator goes onto your website with an iframe: one line of HTML, no plug-in, no library. You choose language and finish in the address; if you want more, you steer it with messages from your own page. This page is for the person who looks after your website.
- iframe
- 1 line
- as of
- November 2026
01 · embedding
The iframe: the configurator in one line
This is how the Ulmer Hocker sits on a page. The address is the real one from our lab; yours comes with the project.
<iframe src="https://alzato.ch/apps/hocker-lab/?embed=1&lang=en"
title="3D configurator: Ulmer Hocker" allow="fullscreen" loading="lazy"
style="width:100%; aspect-ratio:16/10; min-height:560px; border:0"></iframe>On narrow screens the minimum height applies, so that controls and cards have room.
02 · parameters
Parameters: what the address sets
Every parameter is optional.
| Parameter | Values | Effect |
|---|---|---|
embed | 1 · stage | 1: the configurator with its controls, without its own header. stage: only the scene; your page lays its own controls over it. |
lang | de · en | Language of the controls and texts. |
variant | fir · walnut · red … | The finish it opens on, as the share link sets it. |
light | sun · soft · studio | Sun, north light or white studio. |
product | kreuzzargenstuhl … | Which product, when one address carries several. |
intro | 0 | Without the opening in which the parts come together. |
03 · messages
Messages: page and configurator in conversation
With window.postMessage your page steers the configurator, and it reports what the visitor does. This is how the stage on our home page works.
variant | choose a finish |
|---|---|
explode | true or false: take it apart |
drawing | true or false: show the 1 : 1 drawing |
light | sun, soft or studio |
lang | de or en |
detail | fly to a detail; null closes it |
home | true: back to the resting view |
card | false: hide the detail card; your page tells the story |
run | false: draw no frames while it is out of sight |
alzato:ready | ready; with product, finishes and details |
|---|---|
alzato:variant | a finish was chosen |
alzato:detail | a detail was opened or closed |
alzato:explode | taken apart or put together |
alzato:drawing | drawing on or off |
alzato:light | another light |
Example: switch to walnut as soon as the configurator is ready
const frame = document.querySelector('iframe');
window.addEventListener('message', (e) => {
if (e.source !== frame.contentWindow) return;
if (e.data?.type === 'alzato:ready') {
frame.contentWindow.postMessage({ type: 'alzato:set', variant: 'walnut' }, '*');
}
});04 · size and speed
Size and speed: what the configurator loads
| Program | About 245 KB, compressed |
|---|---|
| Ulmer Hocker in spruce, first visit | About 1.3 MB with model, wood photographs and fonts |
| Other woods | Load quietly once the scene is up; the dealer map only when someone opens it |
| Frames per second | 120 on the laptop, 60 on the iPhone 11 Pro |
| Browsers | Chrome, Edge, Firefox and Safari with WebGL 2, on computer, tablet and phone |
| Hosting | By us, in Frankfurt |
Sizes worked out from the configurator’s files on 19 November 2026; frame rates measured on 14 November 2026 in Chrome. Tested on laptop and iPhone; Android measurements will follow.
05 · privacy
Privacy: what the configurator sends
- No cookies, nothing in the browser’s storage, no tracking, no analytics.
- Every file comes from its own address; no third-party fonts or scripts. The one exception: when someone opens the dealer map, it loads its map images from OpenFreeMap.
- Data leaves only when someone submits an enquiry: name, email, postcode and town, message, the chosen dealer and the configuration with a picture, to the address set in the project.
06 · dealers
Dealers: the configurator at your dealers
Dealers embed the same line, in their language. The enquiry goes to the address you set: to you or to the dealer. You give us the list of dealers, we send each one their line.
07 · planned
Planned: script embedding and a Shopify app
Questions about embedding?
Send us your website’s address and the page the configurator should go on. Within two working days you know what it takes.