By tagging materials and meshes in a file, we can request any possible combination of 3D assets from the Variant API.

Variant works on the concept of ‘tagged’ objects in a file. You can tag meshes or materials with names and use them to make meshes visible/invisible, and assign tagged materials to tagged meshes.

Planning your tags carefully up-front will help reduce the time needed to create 3D models, minimize the download size for the user, and simplify adding future variants.

How to add tags

Tags are set in your preferred 3D editor, by editing the name fields of 3D objects. We show that a word is a tag by wrapping it in the special characters: “V[ ]”

For example, if you had a 3D mesh named “armchair” you could tag it as CHAIR by changing the name to: “armchair V[CHAIR]”, or simply “V[CHAIR]”. It doesn't matter if there's other text in the name - the only thing that matters is that our tag-name CHAIR appears surrounded by V[ ].

Tags can only contain numbers, letters and the underscore ‘_’ character. Tags are case insensitive, so there’s no difference between ‘Chair’ and ‘CHAIR’. However, we recommend using uppercase to make tags stand out from other text in the name field at a glance.

Last updated