Types and the configurator

How VUE turns parameters into controls, and how to curate them.

What a type is

A type is one configuration of a product that has actually been converted — the 1200 mm anthracite one. A Revit family typically contains many; an FBX arrives with one.

Everything a visitor can select is a type. VUE does not generate geometry on demand, so the configurator is a way of navigating what exists rather than a way of making new combinations. If a size is not in the family, no amount of configuration will produce it.

How the controls are derived

A flat row of buttons labelled Stelrad - 450mm x 1200mm - Blue is not a configurator. The information a specifier wants is inside those names, and inside the family’s parameters — so VUE reads the parameters instead.

It looks for the smallest set of parameters whose combinations correspond exactly to the list of types. On a real radiator catalogue with 12 types and 103 parameters, that resolves to two controls — form and size — which between them pick out all 12 with nothing missing and nothing duplicated.

Each control gets a shape from what the parameter is:

  • A dimension — a length in millimetres — becomes a dropdown, sorted numerically. This is why the type catalogue matters: it tells VUE the column is a length, so 450 comes before 1000 instead of after it.
  • A material becomes a row of swatch chips, coloured from the material where VUE can match it.
  • A yes/no becomes a pair of options.
  • Anything else that varies becomes a plain dropdown, in the order the catalogue lists it — not alphabetically, because a manufacturer usually orders their finishes deliberately.

Everything else that varies but is not a control — a calculated heat output, a product code — becomes a specification readout that updates as the visitor selects. It is information, not a choice.

Screenshot to addAn embed with a size dropdown, finish swatches and the specification readout below.

Why a parameter did not become a control

The studio lists every parameter VUE rejected and says why. This is deliberate — “why isn’t Finish a dropdown?” should be answerable without asking us. The usual reasons:

ReasonWhat it means
Same on every typeIt does not vary, so there is nothing to choose. It appears in the specification readout instead.
Unique per typeA different value on every single type, with no repeats — that is a product code or a name, not a choice. Twelve types with twelve distinct codes would make a dropdown that duplicates the type list.
Missing on some typesNot present on every type, so it cannot describe the whole family.
Determined by another controlIts value follows from the ones already chosen. Showing it as a control would let a visitor pick a combination that contradicts itself.

Curating the controls

The derivation is a proposal. You can, and generally should, adjust it:

  • Rename a control. An axis Revit calls TypeName with values like “Classic Towel Rail (Straight)” is better labelled “Form”.
  • Rename its values. The raw value is kept as the link to the model; the label is what the visitor reads.
  • Reorder the controls and the values within them.
  • Hide anything internal. A hidden control still resolves — the type it selects is still reachable — it just is not shown.
  • Set a swatch colour on a material value where VUE could not match one automatically.
Screenshot to addThe configurator panel in the studio, with an axis renamed and its values reordered.

Your curation survives re-conversion. It is stored against the parameter name, not against the converted output, so re-uploading an updated family keeps your labels. A value that is new appears at the end with its raw name; one that has gone is kept and flagged rather than dropped silently.

Defining options by hand

An FBX or OBJ has no parameters, and a Revit family occasionally has the wrong ones. In both cases you can define the options yourself:

  1. duplicate the default type once per variation you want;
  2. add a control in the options panel and give it a kind — a material control gets swatches, a dimension gets a sorted dropdown;
  3. give each type its value on that control, and a swatch colour if relevant;
  4. save.

The result behaves exactly like a derived control, because it is the same mechanism — you are supplying the parameter values that a Revit family would have supplied.

This is how you get “change the body colour per type” on a model that arrived as a single mesh.

Combinations that do not exist

Real catalogues are sparse — 1200 mm might come in anthracite and white but 300 mm only in white. VUE handles that without ever showing a dead end:

  • values that are not available given the current selection are greyed out, not hidden, so a visitor can see that a finish exists in another size rather than wondering whether they imagined it;
  • if a choice does invalidate another control, VUE keeps the one just touched and moves the others to their nearest valid value, with a brief highlight to show what moved.

There is deliberately no “no such product” state. It is unreachable by construction rather than handled with a message.

The analytics record when this happens, and it is one of the more commercially interesting numbers on the dashboard — it is a log of combinations people asked for and you do not make.

Variants

A variant is a version of a type you create in VUE rather than in Revit — most often the same geometry in a different finish, using a material from your library. Variants sit alongside the configurator rather than inside it, because they have no parameters to place them on the grid.

See materials and finishes for how to make one.