=== 3D Viewer – Display Interactive 3D Models ===
Contributors: bplugins, abuhayat, shehabulislam, freemius, farazi1
Tags: 3D model viewer, threejs, widget, model viewer, 360° product view
Tested up to: 6.9
Stable tag: 1.8.3
Requires PHP: 7.1
Donate link: https://www.buymeacoffee.com/abuhayat
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

3D Viewer lets you embed interactive 3D models and 360 product views on WordPress sites with support for GLB, GLTF, OBJ, STL, FBX, DAE, and BIM.

== Description ==

**Instantly Display Interactive 3D Models and 360° Product Image on Your Website – No Code Required**

[**3D Viewer**](https://bplugins.com/products/3d-viewer/) | [**Documentation**](https://bplugins.com/docs/3d-viewer/) | [**Pricing**](https://bplugins.com/products/3d-viewer/pricing) | [**Support**](https://bplugins.com/support/) | [**Demo**](https://bplugins.com/products/3d-viewer/#demos)

https://youtube.com/watch?v=_9vKv5pEClM

[**3D Viewer**](https://bplugins.com/products/3d-viewer/) lets you embed interactive 3D models into posts, pages, widgets, and WooCommerce product pages. Utilizing the Three.js library, it supports various 3D file formats, including GLB, GLTF, OBJ, and STL.

The plugin offers features such as touch controls, zoom, pan, auto-rotation, and lazy loading. Users can customize viewer settings, including lighting, background, and camera angles, to suit their needs. Integration with Elementor and Gutenberg editors allows for seamless placement of 3D models using blocks or shortcodes.

In WooCommerce, 3D Viewer facilitates the display of 3D product models, enhancing the user experience by allowing customers to interact with products in three dimensions. The plugin also supports the creation of galleries for multiple product variants.

Designed with performance in mind, 3D Viewer ensures responsive and mobile-friendly rendering of 3D content across devices.


### Free Features – Everything You Need to Get Started

- **Embed 3D Models in Posts, Pages, and Widgets:** Easily place your 3D model anywhere using shortcodes or Gutenberg blocks.

- **Supports Popular 3D Formats:** Upload and display files in .GLB, .GLTF, .OBJ, .STL, and more.

- **WooCommerce Integration:** Show 3D product views right on your WooCommerce product pages to boost engagement and buyer confidence.

- **Touch, Pan, Zoom & Rotate:** Visitors can explore your model with mouse or touchscreen gestures.

- **Auto-Rotation Feature:** Automatically spin your model to create a 360° product view without interaction.

- **Gallery Support for Variants:** Add multiple 3D models (like product variants) into a single viewer gallery.

- **Preset Settings:** Save your preferred viewer configurations and reuse them across multiple models.

- **Elementor Compatible:** Works seamlessly with Elementor to place 3D models with drag-and-drop ease.

- **Lazy Loading for Performance:** Optimize page load speed by loading models only when visible—great for SEO!


### Pro Version – Unlock More Control & Customization
Want even more flexibility? [**3D Viewer Pro**](https://bplugins.com/products/3d-viewer/pricing) adds powerful features that let you fine-tune the viewer, improve performance, and streamline your workflow.

**Pro Features Include:**

- Drag-and-drop **Elementor Widget** with full viewer settings.

- Support for **external model URLs** (Amazon S3, Google Drive, CDNs, etc.).

- Adjust **lighting, shadow intensity**, and **exposure**.

- Add a **poster image** to show while the model is loading.

- Display a **progress bar** until the 3D file is fully loaded.

- Enable or disable **auto-rotate, fullscreen**, and **autoplay**.

- Set a **custom camera angle** for the perfect first impression.

- Create a **WooCommerce gallery** with multiple 3D files per product.


### How to Use 3D Viewer– Quick Start Guide

Getting started is easy!

https://youtube.com/watch?v=ofC8XbdAuVE

#### Step-by-Step Guide

- Go to **3D Viewer > Add New** in your WordPress dashboard.

- Upload your 3D model or paste a URL.

- Customize the viewer settings (lighting, rotation, background, etc.).

- Click **Save** to generate a shortcode.

- Copy and paste the shortcode into any post, page, or widget block.


**To Embed in a WooCommerce Product:**

- Edit or create a WooCommerce product.

- Scroll to the **“3D Viewer Settings”** metabox.

- Upload the model file or paste an external link.

- Publish the product – the 3D model will appear on the product page.


**Gutenberg Block Support**

- Prefer using the block editor? We've got you covered!

- In your Post/Page Editor, go to the Common Blocks section

- Select the **3D Viewer** block

- Choose your desired player

- Hit **Publish**


That’s it – your 3D model is live!

[**Live Demo**](https://bplugins.com/products/3d-viewer/#demos) | [**Try The Pro**](https://bplugins.com/products/3d-viewer/pricing)


### Use Cases

- **WooCommerce Products:** Let customers rotate and inspect 3D product models before buying.

- **Education & Training:** Embed anatomical models, mechanical parts, or scientific visuals for better understanding.

- **Architecture & Engineering:** Showcase 3D building plans or prototypes in client presentations or portfolios.

- **Gaming & Assets:** Display characters, assets, or environmental models for interactive demos or downloads.

- **Art & Design Portfolios:** Highlight your creative work—from sculpture to product design—in an engaging format.

- **Research & Prototyping:** Share experimental models and simulations for collaborative feedback.

- **App & UI Previews:** Present app interfaces or hardware in 3D for investor pitches or beta user onboarding.

- **Packaging & Product Mockups:** Let stakeholders explore physical packaging in real-time before production.


### Supported 3D File Formats

- **- Models:** .GLB, .GLTF, .OBJ, .STL

- **- Optional (Pro):** .FBX, .DAE, .PLY, .3DS


### Optimized for All Devices

- Fully responsive and mobile-friendly

- Touch gesture support (rotate, zoom, pan)

- Retina-ready rendering

- Works with most popular WordPress themes

[**Live Demo**](https://bplugins.com/products/3d-viewer/#demos) | [**Try The Pro**](https://bplugins.com/products/3d-viewer/pricing)


### User Feedback


❛❛**_It’s the most valid plugin I have found for viewing 3D models. The support is also very good and an issue I reported was immediately corrected._**❜❜ 

**_-diegoparoni_**

<br />
<br />

❛❛-_Fantastic plugin the main feature that i like is the 3D model is perfectly loaded and you can adjust the light, am using the PRO version._**❜❜ 

**_-blunoa_**

Like that plugin? Hate it? Want a new feature? **[Send your feedback](https://bplugins.com/support)**


### Check out our other WordPress Plugins-

[**Html5 Video Player**](https://bplugins.com/products/html5-video-player/) – Display videos as single and playlist in multiple skins.

[**Html5 Audio Player**](https://bplugins.com/products/html5-audio-player/) – Listen audios with awesome visuals.

[**PDF Poster**](https://bplugins.com/products/pdf-poster/) – Display/Embed PDF files with different styles.

[**StreamCast**](https://bplugins.com/products/streamcast-radio-player/) – Customizable radio player with different skins.

[**Advanced Post Block**](https://bplugins.com/products/advanced-post-block/) – Show posts and custom posts in different layouts.


== Installation ==

This section describes how to install the plugin and get it working.

e.g.

1. Upload `plugin-directory` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Use shortcode in page, post or in widgets.
4. If you want player in your theme php, Place `<?php echo do_shortcode('YOUR_SHORTCODE'); ?>` in your templates


== Frequently Asked Questions ==

= Which 3D files currently this plugin support?  
Currently this plugin support .glb, .gltf files. 

= Can I use this plugin with Elementor page builder ?  
Yes, you can paste the shortCode of 3D Viewer and paste it inside Elementor's Shortcode elements. 

= I have a .fbx file, can I embed that file using the 3D Viewer Plugin?
No, This plugin only support .glb and .glTF files. Please convert your file to any supported file types and upload it to your site.

= How can I reach you, if I need any modification, customization or helps?
[Please follow this link to reach us directly ](https://bplugins.com/support)


== Screenshots ==

1. Add New 3D
2. 3D Configuration
3. Single and Multiple Preview
4. 3D Product at top of the image
5. 3D Product at bottom of the image
6. Product image replaced with 3D Pro
7. Show 3D based on product variable
8. Settings
9. Gutenberg Block
10. Gutenberg Block Settings


== Changelog ==


= 1.8.3 - 17 Dec, 2025  =
Fixed: new shortcodes were not working properly.

= 1.8.2 - 4 Dec, 2025  =
* Feature: Option to add Link on hotspot (Premium)
* Improved: Some JS and CSS coding
* Feature: AR mode on Classic Shortcode Generator

= 1.8.1 - 5 Nov, 2025  =
* Update: Library update
* Fixed: Flatsome theme conflict
* Removed: Hand tool on the model
* Featature: Fullscreen Button on iPhone


= 1.8.0 - 15 Sep, 2025  =
* New Page: Dashboard
* Added: Visual Editor
* Feature: Show 3D on First Image of Woocommerce Gallery
* Fixed: Broken Product Page Layout
* Fixed: public.css not found
* Improved: Code
* Feature: Set Initial View (Premium)
* Feature: Argument Reality (AR) (Premium)
* Feature: Option to add Hotspot/Annotation (Premium)
* Feature: Lock X/Y Axis Rotation (Premium)
* Feature: Capture Button (Premium)
* Feature: Zoom In/Out Button (Premium)
* Feature: AR view using QR code (Premium)
* Added: Presets (Premium)
* Improved: Display 3D models in shop pages and product listings (Premium)


= 1.7.0 - 9 Jul, 2025  =
* Fixed: AR Icon on iPhone
* Fixed: Fatal/Critical error on product page
* Fixed: Showing Different 3D Models for Product Variations in WooCommerce when single attribute
* Fixed: Fullscreen does not work on iPhone
* Fixed: 3d_viewer_product shortcode does not work properly
* Feature: Field to add Skybox Height
* Feature: Show model based on multiple product variable
* Feature: Added Loader

= 1.6.3 - 7 May, 2025  =
* Fixed: _load_textdomain_just_in_time was called incorrectly

= 1.6.2 - 12 Feb, 2025 (Pro) =
* Feature: Option to Show Edge and Customize the color (Advanced Viewer, Premium)
* Option: Enable/Disable Zoom (Advanced Viewer)
* Option: Enable/Disable Zoom (Woocommerce)

= 1.6.1 - 12 Feb, 2025 (Pro) =
* Fixed: can't read properties of undefined percentageWrapper

= 1.6.0 - 5 Feb, 2025 (Pro) =
* Option: Add HDR skybox image (Premium)
* Option: Tone Mapping (only available on Gutenberg) (Premium)
* Feature: Apply Factor and Texture to a model (only available on Gutenberg) (Premium)
* Feature: Modify Material using Texture option (only available on Gutenberg) (Premium)


= 1.5.1 - 1 Feb, 2025 =
* Update: WordPress SDK

= 1.5.0 - 03 Sep, 2024 =
* Feature: Set Skybox Image to the model
* Feature: AR Feature 
* Fixed: Rotation delay


= 1.5.0 - 03 Sep, 2024 =
* Improved: code
* Feature: Option to display a poster/image until the model loads.
* Feature: Compatible with most themes
* Fixed: Does not work fullscreen on product shortcode

= 1.4.2 - 27 June, 2024 =
* Fixed: create dynamic property

= 1.4.0 - 24 March, 2024 =
* Feature: Set Zoom Level
* Feature: Set Environment Image

= 1.3.28 - 3 Mars, 2024 =
* Fixed: WoodMart Single product image CSS

= 1.3.27 - 12 Feb, 2024 =
* Fixed: Custom Angle

= 1.3.26 - 7 Feb, 2024 =
* Fixed: Modal width issue

= 1.3.25 - 28 Jan, 2024 =
* Feature: Lite/Advanced viewer added on WooCommerce product

= 1.3.24 - 17 Jan, 2024 =
* Improved: Custom Selector

= 1.3.23 - 7 Dec, 2023 =
* Improved: Pricing page

= 1.3.20 - 23 Nov, 2023 =
* Fixed: $product is not defined

= 1.3.19 - 11 Nov, 2023 =
* SDK Updated

= 1.3.17 - 12 Oct, 2023 =
* Fixed Single product view on Divi theme

= 1.3.16 - 5 Oct, 2023 =
* model/popup on product page for 3D
* Fix Poster issue

= 1.3.15 - 24/08/2023 =
* Fix OV is not defined

= 1.3.14 - 17/08/2023 =
* Fix Elementor Issue
* Viewer 2 in classic shortCode Generator

= 1.3.11 - 29/07/2023 =
* Fix Percentage issue

= 1.3.11 - 19/07/2023 =
* Fix Percentage issue

= 1.3.10 - 17/07/2023 =
* Fix Settings page issue

= 1.3.9 - 11/07/2023 =
* Gutenberg Shortcode Generator
* Woocommerce  Custom Selector

= 1.3.8 - 30/03/2023 =
* Fixed: Full Screen button issue
* Fixed: SSL issue on woocommerce

= 1.3.3 - 04/09/2022 =
* added apply_filters hook to add attribute on model

= 1.3.1 =
* Fixed full screen issue

= 1.2.9 =
* Fixed width issue

= 1.2.7 =
* SDK Updated

= 1.2.6 =
* Fix mirror issues

= 1.2.5 =
* Fix Product Metabox issues.
* Fix Other mirror issues

= 1.2.4 =
* Fix mirror issues.

= 1.2.3 =
* Fix Product issues.

= 1.2.2 =
* Improve Performance.
* Fix mirror issues.


= 1.2.1 =
* New Shortcode Generator
* Fix mirror issues.


= 1.2.0 =
* Woocommerce Support 
* Multiple Source Option for Models
* Dedicated Settings Panel.
* Preset Settings


= 1.1.1 =
* Full Screen Feature Added
* Custom Angle Supported For Specific Model 
* Script Improved
* Fix other issues

= 1.1.0 =
* Added New Feature In Pro 
* Optimize Option Panel
* Script Improved
* Progress bar issues
* Fix other issues

= 1.0.10 =
* Fix old Version shortcode Issues.
* Script Improved
* Fix mirror issues

= 1.0.9 =
* Multiple Shortcode Support in same page / post.
* Script Updated
* Responsiveness improved
* Fix mirror issues

= 1.0.8 =
* Fix https issues. 

= 1.0.7 =
* Auto Rotation speed and delay option added ( Pro Only ).
* Fix mirror issues. 

= 1.0.6 =
* New Exclusive Feature Included.
* Fix mirror issues. 

= 1.0.5 =
* New Exclusive Feature Included.
* Fix mirror issues. 
* Updated script

= 1.0.4 =  
* New Feature Include.
* Fix mirror issue. 
* Updated script

= 1.0.2 =
* Fix mirror issue. 
* Updated script

= 1.0.1 =
* Fix json issue. 

= 1.0.0 =
* Initial Release



== Upgrade Notice ==

= 1.3.26 - 7 Feb, 2024 =
* Fixed: Modal width issue

= 1.3.17 - 12 Oct, 2023 =
* Fixed Single product view on Divi theme

= 1.3.16 - 5 Oct, 2023 =
* model/popup on product page for 3D
* Fix Poster issue