Troubleshooting

Fixes for the problems that come up most: a family that found only one type, grey materials, a blank or blocked embed, missing FBX textures, and AR that will not launch.

My family has 40 sizes but VUE only found one type

Almost always a type catalogue that did not come with the family. Revit keeps the type list for a large family in a separate .txt next to the .rfa, and without it VUE only sees the types embedded in the family itself — usually a single placeholder.

Upload the pair together. If you are not sure the family has one, look for a .txt with the same name in the same folder. More in uploading models.

The model converted but everything is grey

VUE keeps the materials the file assigns and cannot invent ones that were never set. Geometry left as <By Category> in Revit has no material of its own, so it arrives grey.

Two fixes:

  • assign real materials in the family and upload it again — the better fix, because it also helps everyone using the family in Revit; or
  • override the materials in VUE, which needs no re-conversion. See materials and finishes.

My FBX has no textures

An FBX does not contain its textures — it points at them by a path on the machine that exported it, which does not exist on our side.

Zip the FBX together with its texture files and upload the zip, or select the textures alongside the model in the upload picker. Filenames must match what the model asks for, including capitalisation. See sending textures.

The embed shows a licensing notice on my website

The embed has an allowed-domain list and the page it is on is not in it. Add the domain in the embed’s options.

Include every variant the page is actually served from — www and non-www are different, and your staging site is different again. See locking it to your domains.

The embed is blank or collapsed to nothing

An iframe with no height collapses to zero, and the viewer fills whatever box it is given. Set a height, or wrap it in an aspect-ratio box — 4:3 works well for most products.

If it has a height and is still blank, check the browser console on the page for a content-security-policy message: a strict policy on your own site can block the frame.

View in AR does nothing on my phone

Three causes, in order of likelihood:

  • The page is not HTTPS. Camera access is not granted to an insecure page, so AR cannot start. It will work on the VUE share link and fail on your own page — which is the giveaway.
  • The device does not support it. Android needs Google Play Services for AR.
  • It places something the wrong size. That is the units in the source file, not AR. See scale, and why it matters.

A conversion failed and I want to know whether I was charged

If the engine failed on our side, the time is not charged. If the file was genuinely invalid, the engine may have consumed time working that out, and in that case it counts.

Settings shows conversion time broken down by model, so you can see exactly what a failed job cost. If it looks wrong, raise a ticket — we can see the per-job engine time.

My analytics show zero even though the page is live

Confirm the iframe on your page uses the embed address from the embed panel, and that the domain is allowed — a blocked embed shows a licensing notice and records nothing.

Daily totals are what the charts read, so today’s figures firm up through the day. If a page has genuinely been live for a day and the count is still zero, that is a ticket.

A colleague signed up and cannot see our models

Signing up independently creates a new organisation, and organisations cannot see each other. Invite them properly from Manage team — since they already have an account, the invitation adds your organisation to it rather than making a third.

They can then switch between the two from the header. If they have already uploaded models into the wrong one, raise a ticket and we can move them.

A parameter I care about did not become a control

The studio shows the full list of rejected parameters and why each one was rejected, so this is answerable without asking us.

If the reason is wrong for your data — it happens on unusual families — you can define the control by hand instead. See defining options by hand.


Not here?

Raise a ticket and include the model name, where you saw it and the build stamp from the footer. See what to include.