Working with Widgets > 3D > Product
Product
* 
This widget is only available with Vuforia Studio and Experience Service 10.0.0 and later.
What Does This Widget Do?
The Product widget allows you to retrieve reusable assets, such as models and Model Targets, without writing any code. It automatically pulls product-specific data that was previously uploaded and generated on the Experience Service using the Product API, making it easy to integrate dynamic content into your experiences. For more information, see Vuforia Studio Product API.
When Should I Use This Widget?
Use a Product widget in any experience where you want to dynamically load models and Model Targets from your Experience Service. Simply connect the Product widget to the Model widget and Dynamic Target widget to ensure that the retrieved assets are loaded seamlessly at runtime—no scripting required.
When using this widget, the experience follows a defined logic:
• If the model has been simplified, the experience automatically retrieves the “Medium” quality version.
• If multiple Model Targets are available, the experience prioritizes loading the highest available quality in the following order: Advanced, On-prem Advanced, and then Standard. When multiple versions exist within the same quality tier, the latest version is selected automatically.
For a step-by-step walkthrough, check out Use Case: Load and Compare Assets Dynamically.
Are There Any Special Properties, Services, Events, or Actions?
To view a list of common widget properties, services, and events, see Common Widget Properties, Services, and Events.
* 
If you are unsure about which version of the Experience Service you are running, contact your administrator.
Property Name
JavaScript
Type
Description
Product ID
productID
string
Product ID of the product.
Version
version
string
Specifies the version of the product. A product may have multiple versions. If no version is provided, the latest available version is used by default.
* 
"Latest" refers to the most recently created version, not necessarily the one with the highest version number.
Model
modelUri
string
Model resource URL of the product. (.pvz file)
Target
targetUri
string
Target resource URL of the product. (.dat file)
* 
The Product widget is used to load and display product data based on a Product ID and an optional version. If you provide both a Product ID and a version, the widget will load that specific version of the product. If you only provide a Product ID and leave the version blank, the widget will automatically load the latest version of the product.
Event
JavaScript
Description
Product Loaded
productLoaded
Triggered once the Product-related URLs have been successfully retrieved. To detect when the model has fully loaded, use the modelLoaded event of the Model Target widget.
Product Failed
productFailed
Triggered when the loading of the product fails.
* 
If the Product ID or Product ID-Version combination you provide cannot be found, the Product Failed event will be triggered. This event does not automatically display an error message in the user interface. As the experience author, it’s your responsibility to handle this event and create any necessary error notifications or fallback behavior for your experience; this gives you full control over how missing product data is communicated to your users.
Example Use Case
See the following use cases:
Was this helpful?