Beta: The 3D view is a beta feature. It is fully usable but may still change. It is free during the beta and is enabled by our support; afterwards it becomes the 3D add-on at €49 per month, included in the Enterprise licence at no extra cost. Feedback is welcome at support@justselling.de.
With the 3D view, your configurator shows a real 3D model instead of a product image. Your customers turn and zoom the product, and the model follows every selection: dimensions scale it, options show and hide parts, colours and surfaces change, and custom text or a logo from the product designer appears right on the product. Typical examples are garages and carports, furniture, glasses and packaging.
This article shows how to set up the 3D view in the admin. What a suitable model looks like is described in Preparing a 3D Model.
Requirements
- Frontend engine V3. The 3D view is only available with V3. More on this: Frontend engine: Legacy or V3.
- A 3D model in GLB format (binary glTF 2.0), at most 25 MB.
- Activation for your service order. Without it, the admin does not offer the 3D view.
Switching on the 3D view
- Open the component and go to Settings → General.
- Under Combined product image, choose 3D view (beta) for Combined image.
- Upload your model under 3D model (GLB): drag the file into the box or click it.
After the upload, configento.app checks the file and shows how many parts, materials, triangles and textures it has. Notes appear right below, for example if the file is larger than 10 MB, has more than 300,000 triangles or contains parts without a name. Replace uploads a new version, Remove deletes the model.
Parts and materials lists all names from the model. Materials marked UV can carry a texture or a print.
Connecting parts to the configuration
Under Bindings you set what the configuration does to the model. Every field takes a number or a formula with $internal_name, just like the formulas in the configurator.
Variables
You calculate variables once and use them in every field below. Example for a garage whose width is entered in millimetres:
| Variable | Formula |
|---|---|
W |
$width / 1000 |
L |
$length / 1000 |
Parts
+ Bind a part… picks a part from the model. Each part has:
| Field | Effect |
|---|---|
| Visible if | Empty = always visible. A condition such as $door == 'roller' shows the part only for that selection. |
| Position (m) | Moves the part, per axis X, Y, Z, e.g. W / 2 for a side wall. |
| Rotation (°) | Rotates the part around X, Y, Z. |
| Scale | Scales the part, e.g. W for a wall that grows with the width. |
Materials
+ Bind a material… picks a material from the model:
| Field | Effect |
|---|---|
| Colour | A fixed colour code such as #383E42 or a formula, e.g. $glass_colour if the value of a characteristic is a colour code. |
| Surface | Plaster, Carbon look, Metal, Wood, Glass, Green roof or Solar panels. as modelled leaves the material as it is in the model. |
| A field from the product designer (custom text or custom image). Its label is printed onto the material as Print (in colour), Satin (milky, matt) or Foil (metallic). |
The surface can be a formula too, e.g. $finish == 'gold' ? 'foil' : 'print'.
Connecting values to the model
Often a colour does not depend on a formula but on a particular value, such as “Anthracite grey” in a list of door colours. For this, every value has the 3D view (beta) section:
| Field | Effect |
|---|---|
| Material | The material this value colours. |
| Colour | The colour code. From title proposes a colour from the title, for example from “RAL 7016”, “Anthrazitgrau” or “Blau”. |
| Surface | As above, e.g. Carbon look for a fascia in carbon look and Plaster for the plastered version. |
| Show parts / Hide parts | Parts that appear or disappear only with this value. |
| Number for formulas | For size lists: the size the value stands for, e.g. 2.55 for “2.55 m”. In the formulas above it is available as $width.number. |
Only the selected, visible value takes effect. If you have several colour lists of which only one is visible depending on the selection, the right one always applies.
Colours for all values at once
On the characteristic, below the values, you find the 3D colours from titles section. Choose the material and click Apply to … values: configento.app sets material and colour for every value whose title contains a colour. Values without a recognisable colour are marked with a dashed border. Colours you have already set stay, unless you tick Overwrite colours already set.
The colour recognition currently knows RAL numbers, German RAL names and German colour words.
Scene and turning
| Setting | Effect |
|---|---|
| Scene | Studio (neutral) for most products, Glass studio (dark, for glass and metal) for glasses, bottles and shiny metal. The outdoor photos (suburb, rural, commercial area) are in preparation; until then the view shows the studio there. |
| Turning | Product turns (turntable; light and shadow stay) for products in the studio. Camera circles the product (for outdoor scenes) for outdoor scenes in which the surroundings should stay in place. |
| Turn automatically | The product turns slowly until your customer touches it. |
| Compact layout | Choices as a row of buttons, colour swatches as small tiles and the text designer in a 2 × 2 grid, so the options fit next to the 3D view. |
What your customer sees
- the 3D model in place of the product image, with shadow and studio light,
- drag to turn, mouse wheel or two fingers to zoom, plus buttons to zoom in and out, go back to the start view, switch turning on or off and go full screen,
- with a product designer field, the flat design surface below the model: there your customer moves and scales text and logo, and the model shows the result.
Without WebGL, or if the model cannot be loaded, the configurator shows the normal product image instead. So give your values pictures anyway if you want a fallback.
In the cart, PDF and email
The cart, emails and the PDF get a picture of the current 3D view, as your customer last saw it. Prices, rules and required fields work unchanged.
Checking and publishing
Save and open the Preview: it shows the 3D view as in the shop. The check on saving points out if the 3D view is switched on but no model is uploaded, or if a binding names a part or material the model does not have. Then publish as usual.
ZIP export, import and duplicating take the model along. The copy gets its own model file.
Troubleshooting
- The “3D view (beta)” entry is missing: The 3D view is not yet enabled for your service order. Contact support.
- The upload is refused: The file is not a GLB (glTF 2.0) or is larger than 25 MB. Export the model as
.glb, see Preparing a 3D Model. - A part does not react: Check in the notes of the check that the name matches the part in the model exactly. Parts without a name cannot be bound.
- A part grows in the wrong direction: The pivot of the part is in the wrong place in the model. More in Preparing a 3D Model.
- The print does not appear on the model: The material has no UV coordinates (no UV in the list) or the designer field is empty.