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.

ParameterValuesEffect
embed1 · stage1: the configurator with its controls, without its own header. stage: only the scene; your page lays its own controls over it.
langde · enLanguage of the controls and texts.
variantfir · walnut · red …The finish it opens on, as the share link sets it.
lightsun · soft · studioSun, north light or white studio.
productkreuzzargenstuhl …Which product, when one address carries several.
intro0Without 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.

To the configurator ({ type: 'alzato:set', … })
variantchoose a finish
explodetrue or false: take it apart
drawingtrue or false: show the 1 : 1 drawing
lightsun, soft or studio
langde or en
detailfly to a detail; null closes it
hometrue: back to the resting view
cardfalse: hide the detail card; your page tells the story
runfalse: draw no frames while it is out of sight
From the configurator
alzato:readyready; with product, finishes and details
alzato:varianta finish was chosen
alzato:detaila detail was opened or closed
alzato:explodetaken apart or put together
alzato:drawingdrawing on or off
alzato:lightanother 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

ProgramAbout 245 KB, compressed
Ulmer Hocker in spruce, first visitAbout 1.3 MB with model, wood photographs and fonts
Other woodsLoad quietly once the scene is up; the dealer map only when someone opens it
Frames per second120 on the laptop, 60 on the iPhone 11 Pro
BrowsersChrome, Edge, Firefox and Safari with WebGL 2, on computer, tablet and phone
HostingBy 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

see the roadmap

  • A script instead of an iframe planned

    One line of JavaScript that places the configurator in your page without an iframe. Planned.

  • Shopify app planned

    The configurator on Shopify product pages, connected to the cart. Planned.

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.