3D Model Issues

When you generate a 3D model, it goes through several stages. You can see the current status on your dashboard next to each menu item:

• Pending — The model generation request has been queued and is waiting to be processed. This usually lasts only a few seconds.
• Generating — Our AI is actively creating the 3D model from your photo. This typically takes 2 to 5 minutes depending on the complexity of the dish.
• Processing — The raw 3D model is being optimized for fast loading on mobile devices. This includes compressing textures, reducing polygon count, and applying efficient encoding.
• Ready — The model is complete and live on your menu. Customers can now interact with it in 3D.
• Failed — Something went wrong during generation. This can happen if the source photo is not suitable for 3D conversion. See the troubleshooting tips below.

Interactive 3D models require WebGL, a browser technology for rendering 3D graphics. Most modern browsers support WebGL:

• Chrome (desktop and mobile) — Full support
• Safari (desktop and iOS) — Full support
• Firefox (desktop and mobile) — Full support
• Samsung Internet — Full support
• Older browsers — May have partial or no support

If a customer's browser does not support WebGL, the menu automatically falls back to showing the photo instead of the 3D model. The customer still sees your menu item — they just cannot rotate and zoom it.

MenuGaze automatically detects the customer's device capabilities and chooses the best viewing experience:

• High-end devices (4+ GB RAM, modern GPU) — Full interactive 3D with React Three Fiber rendering, smooth rotation and zoom
• Mid-range devices (2-4 GB RAM) — Uses Google Model Viewer for a lighter 3D experience with the same visual quality
• Low-end devices (under 2 GB RAM, no WebGL) — Falls back to the poster image or original photo

This automatic detection means you do not need to worry about different devices. Every customer sees the best experience their device can handle.

If a model generation fails, you can try again by clicking the "Retry" button on your dashboard. Before retrying, consider whether the source photo is suitable:

• The dish should be clearly visible and well-lit
• Avoid photos with heavy shadows, filters, or overlaid text
• The photo should show the food from above or at a 45-degree angle
• Avoid photos where the dish is partially cut off by the frame

If the same photo fails repeatedly, try uploading a different photo of the same dish and generating the model from that instead. Some compositions work better for 3D conversion than others.