Woo 3D Viewer


Simple WordPress/WooCommerce product 3D viewer.
Has a visual shortcode builder where you can upload the 3D model and adjust settings like color, background, reflection, light sources, shadows, etc. The shortcode can be pasted to any page or a post.
In the WooCommerce admin the plugin adds a new “Product model” box underneath “Product Image”.
Supported file types: STL, OBJ/MTL, VRML, GLTF (including textures and animation), ZIP.


  • Visual shortcode builder.
  • WooCommerce integration.
  • WooCommerce products have an option to keep the product image and show “View 3D” button
  • Files supported: STL (bin,ascii), OBJ (including MTL support), VRML, GLTF (including textures and animation), ZIP.
  • Adjustable scene – background color, shadows, ground mirror.
  • Adjustable model – color, shininess, transparency.
  • Browser support: works best with WebGL enabled browsers.
  • PRO version: Can have multiple 3D viewers on the same page (10 maximum).
  • PRO version: Can convert models to PNG, animated GIF, WEBM video format to protect models from downloading or improve the customer experience on mobile.
  • PRO version: Option to show a WEBM or a GIF instead of 3D model on mobile devices.
  • PRO version: Model compression (for faster model loading)
  • PRO version: Can load models from 3rd party sites with shortcodes.
  • PRO version: Model repair feature (STL, OBJ).
  • PRO version: Model polygon reduction feature (STL, OBJ).
  • PRO version: Variable product support.




  • Frontend
  • Backend - general settings
  • Backend - shortcode builder settings


WordPress usage:

  • Make sure you have Load Everywhere option enabled in General Settings
  • In the admin navigate to Woo3DViewer page, Shortcode Builder tab
  • Set model
  • Click “Generate” button to generate the shortcode
  • Paste the shortcode to any page or a post

WooCommerce usage:

  • Make sure you have WooCommerce installed
  • Create a new product or edit an existing one
  • Underneath “Product Image” check “Product model” box
  • Click “Set model” and upload your model
  • Publish the product
  • Now you can alter model settings (color, transparency, etc) in “Product model” box
  • Save the product again


How do I upload OBJ model with MTL?

Upload a zip file that contains obj, mtl and texture files.

My “Maximum upload file size” is too small, what should I do?

Either ask your tech support to increase post_max_size and upload_max_filesize values or use a specific plugin that does the job.

How do I translate the plugin?

The easiest way is to use this plugin https://wordpress.org/plugins/loco-translate/


May 23, 2020
Plays with WordPress file permissions. Upload folder fails. He wants you to install a plugin. when that plugin is installed, it shows ads on your web page. (Protect Uploads Plugin)
November 23, 2018
This plugin is amazing, it works perfectly right away with now configuration and fits so well into the woocommerce product page. The only issue I have is it is a bit slow when loading up the 3D model file so maybe some optimisation could be made to improve it. But apart from that it is really great and thank you so much to the creator keep on doing what you love and the value you give to people will be returned 🙂
Read all 5 reviews

Contributors & Developers

“Woo 3D Viewer” is open source software. The following people have contributed to this plugin.


Translate “Woo 3D Viewer” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.


  • Less model cropping on zoom

  • New option in general settings – Enable Controls
  • “Edit/Preview” product bugfix
  • Wireframe bugfix
  • WordPress 5.6 tested
  • WooCommerce 4.8 tested

  • Edit/Preview product model popup bugfixes
  • “Set Model” bugfix
  • WooCommerce 4.6 tested

  • Toolbar controls – wireframe view button
  • Fullscreen mode – keep toolbar controls
  • Fullscreen mode – product page fix
  • Double-click to enter the fullscreen mode
  • Loading image centering fix
  • WooCommerce 4.5 tested

  • Bugfix

  • Better texture support for GLTF/GLB models
  • Reload the shortcode builder page when a new model is set
  • Bugfix for variable products

  • Bugfix for textures in zip files with spaces in file names
  • WooCommerce 4.2 tested

  • Removed “Protect Uploads” plugin recommendation

  • “Show Controls” option per shortcode
  • WooCommerce products have an option to keep the product image and show “View 3D” button
  • Minor CSS adjustments
  • WooCommerce 4.1 tested
  • PRO: Multiple viewers on the same page (10 maximum)

  • Default settings: added Model Color option

  • Removed unnecessary functions
  • Minor CSS adjustments


  • New option in General Settings: Show controls (enabled by default)
  • Bugfixes


  • Shortcode builder zip upload fix


  • Visual shortcode builder
  • Can be used without WooCommerce
  • GLTF format support
  • VRML format support
  • Fog option
  • Remember camera position option
  • Better plane/grid creation according to model size
  • “Fit camera” button
  • Light sources are configurable
  • Product/shortcode individual scene settings

  • Ignore folders staring with __MACOS in zip files

  • Fixed obj models on mobile browsers

  • Use MeshLambertMaterial instead of MeshPhongMaterial on mobile devices

  • Updated Three.js to r101
  • Mobile view bugfix
  • PRO: model repair feature
  • PRO: variable product support

  • Rotation bugfix


  • Backend: model is previewed in a popup window

  • Switched from window.onload to document.ready

  • Models displayed rotated bugfix

  • Manual rotation option
  • MTL bugfix

  • Minor bugfixes

  • Multi-site bugfix

  • Option to preview 3D models in the admin
  • Option to disable animation on mobile devices
  • Bugfixes
  • PRO version: ability to convert models to animated GIF and WEBM video to protect models from downloading


  • Color picker fix.


  • Bugfix.


  • Initial release.