Skip to main content
All CollectionsGeneral
Annotations in the 3D viewer

Annotations in the 3D viewer

Learn how to add annotations to your 3D models

Mattias Österberg avatar
Written by Mattias Österberg
Updated over a week ago

Annotations allow you to highlight specific product details—like materials, features, or design elements—directly within the 3D experience. It’s a powerful way to enhance the customer journey by providing context that isn’t always visible at first glance.

Annotations are an optional add-on. If you don’t see it in your platform, reach out to your Customer Success Manager to enable the feature. Also keep in mind that it is a feature under development that will soon be enhanced, we welcome any feedback regarding both user experience and user interface.

Where to find and manage annotations

You can manage annotations from the model detail page in the platform. Navigate to Manage, select a model, and click the “Edit annotations” button located just beneath the 3D Viewer. Here, you can:

  • Add new annotation points

  • Assign localized descriptions

  • Upload supporting images and content

Once saved, annotations appear automatically in the 3D Viewer—no extra code is required.

Localization behavior

When displaying annotations, the system selects the appropriate description based on the locale used on the web page. Here's how it works:

  1. First, it checks for a description with the full locale (e.g. sv-SE)

  2. If missing, it falls back to the language only (e.g. sv)

  3. If still missing, it checks for a generic fallback using *

  4. If no match is found, it returns the first English description (e.g. en)

  5. If nothing is available, the annotation point is not shown

Tip: If you're not using multiple translations, just use a simple language code (e.g. en) or the generic *.

Display settings (via dist settings)

You can control how and when annotations appear using Distribution Settings in the platform:

  • Show by default: Annotations will appear immediately when the model loads

  • Trigger via toggle: A small button will let users toggle annotations on/off

Image guidelines

Images used in annotations will automatically crop to a 2.35:1 aspect ratio. This ensures they are optimized for mobile users and displayed correctly across devices.

Best practices

  • Focus on what makes the product unique — materials, interior features, construction, or technical details

  • Use clear, concise, and engaging copy. Short headlines and body texts work best

  • Choose mobile-friendly images with the right aspect ratio (2.35:1)

  • Add localized descriptions to support international users or use * for universal messaging

  • The view angle and zoom level you set when placing the annotation point will be saved and shown to the end-user when they click it. Use this to guide their attention to the right spot on the product

Did this answer your question?