3D Models

Upload OBJ/MTL 3D models for live product previews, and choose studio or classic lighting for each model.

The 3D Models page lets you upload and configure 3D model files used for live product previews in the Print Editor. PrintNow supports 3D models created with Boxshot software or other tools like Blender that can export OBJ models. A common use case is print packaging products like boxes and other folded dimensional products, but there are many other potential applications for 3D models with web-to-print.

Uploaded models must be OBJ/MTL files. Models get the store's studio lighting from 3D Environment and a realistic material look, matching Print CAD products.

The Stock, Mats and Frames tabs that used to be on this screen are gone. Stocks, mats and frames are now entries in 3D Materials, with types Stock, Mat and Frame. Their wall-art settings (sizes, frame width, overhang, recess) are in the material's Wall art section.

3D Models List

The 3D Models screen shows all uploaded model files in a searchable, paginated grid.

From your Unified Admin, go to Print Editor > Live Previews > 3D Models.
Use the search bar in the top right to filter models by name.
Click Add 3D Model to upload a new model.

3D Models Grid Columns

Column	Description
Id	Unique identifier for the 3D model.
Name	The display name of the model.
Lighting	Studio, Classic, or Classic (Meson Code doesn't parse). See Lighting.
Upload Pages	The texture names used for customer artwork.
Action	Menu with Edit, Delete, Download OBJ, and Download MTL options.

Add/Edit a 3D Model

Click Add 3D Model from the list view, or choose Edit from the action menu on an existing model.

Field	Description
Name	Required. The display name for this model.
Model File (OBJ)	The 3D geometry file. Accepts `.obj` and `.jar` formats. Required when creating a new model.
Program File (MTL)	The material/texture definition file. Accepts `.mtl` and `.jar` formats. Required when creating a new model. MTL files that use texture options such as `-clamp on` load correctly, and their faces keep their page names for customer artwork.
Meson Code	Optional configuration code for the 3D viewer. See the parameters below. An empty Meson Code saves as empty.
Lighting	Studio (store 3D environment) or Classic (MTL materials, fixed lights). See Lighting.
Upload Pages	Override texture names for custom upload products. For multiple textures, separate names with a comma.

Meson Code Parameters

The Meson Code field accepts optional configuration parameters:

'AutoRotate':true,
'BackgroundColor1':'#eeeeee',
'BackgroundColor2':'#999999',
'BackgroundImageUrl': 'Insert base64 output here',
'Lighting':'classic'

AutoRotate -- Set to true to enable automatic rotation of the model. Defaults to false.
BackgroundColor1 and BackgroundColor2 -- Create a gradient background.
BackgroundImageUrl -- Load a base64-encoded image behind the model.
Lighting -- Set to 'classic' to keep the model's previous look. The Lighting field sets this for you.

The old applet fill, width and height options are no longer read; the viewer ignores them.

Lighting

Option	Look
Studio (store 3D environment)	The default. The model is lit by the store's 3D Environment, with the same realistic material look as Print CAD products.
Classic (MTL materials, fixed lights)	The previous look: the MTL file's materials under fixed lights. Choosing it adds `'Lighting':'classic'` to the Meson Code; choosing Studio removes it.

If the Meson Code can't be read, the Lighting field is disabled. Edit the Lighting key in the Meson Code directly.

Stock Look on Models

A model takes the look of the stock the customer picks in the calculator, the same way Print CAD products do. The stock is the option item's 3D Material, linked through Appearance material (3D preview).

A model surface whose texture name exactly matches a product page name takes the stock's front look.
If that page name ends in "inside" or "back" (any case), the surface takes the stock's back look. Both front/back and inside/outside naming work.
Surfaces whose texture names don't match a page name keep their MTL look. This is the same rule that maps the design onto the model.

The stock look applies only with Studio lighting, not Classic.

Assigning a 3D Model to a Product

Go to Products and select the category containing the target product.
Edit the product and navigate to the Print Editor tab.
Set Preview Type to 3D Custom and select the model in the 3D Model field. Tick Live split view to show the model beside the design canvas while the customer designs. See Preview Type.
Click Save.
Publish the product and test the model on the storefront to verify accuracy.

Associations

Print Editor

Area	Effect
Product Preview Type	3D models are assigned to products via the Print Editor tab on the product edit page. Set Preview Type to 3D Custom, then pick the model in the 3D Model field.
Custom Upload	A custom-upload product whose template uses a 3D Custom preview is created with Live split view, so the customer sees the flat pages and the 3D model together.
Three.js Rendering	The Editor UI uses Three.js to render the 3D model preview with the uploaded OBJ/MTL files, lit by the store's 3D Environment unless the model uses Classic lighting.
Material Assignment	Stock, mat, and frame looks come from 3D Materials, assigned to pricing option items through Appearance material (3D preview).

3D Materials — stocks, mats and frames for 3D previews
3D Environment — the studio lighting models use
Products — assign 3D models to products via the Print Editor tab
Editor Settings — configure global editor defaults that affect 3D preview behavior
Product Setup — set the Preview Type and select a 3D model for each product

3D Models

On this page