Display interactive 3D models (STL, OBJ, GLB, GLTF) with Gutenberg blocks and shortcodes.
| Author: | arieslab (profile at wordpress.org) |
| WordPress version required: | 6.6 |
| WordPress version tested: | 6.9.4 |
| Plugin version: | 1.1.0 |
| Added to WordPress repository: | 06-01-2026 |
| Last updated: | 14-02-2026 |
| Rating, %: | 100 |
| Rated by: | 1 |
| Plugin URI: | |
| Total downloads: | 277 |
| Active installs: | 20+ |
Click to start download
|
Press3D is a powerful and feature-rich WordPress plugin that enables you to display interactive 3D models directly on your website. Built with the industry-standard Three.js library, it provides a professional-grade 3D viewing experience with extensive customization options.
Supported 3D Model Formats:
- STL – Popular for 3D printing and CAD models (binary and ASCII)
- OBJ – Universal 3D format compatible with most 3D software
- GLB – Binary glTF format (recommended for best web performance)
- GLTF – Text-based glTF format with separate asset files
Key Features:
- Gutenberg Block Integration – Native WordPress block editor support with live preview
- Shortcode Support – Use
[press3d id="123" version="1"] anywhere in your content with version control
- Interactive 3D Viewer – Rotate, zoom, and pan with mouse or touch controls
- Camera State Persistence – Saves and restores exact camera position and orientation
- Auto-Rotate Mode – Automatic model rotation with adjustable speed (-10 to +10)
- Material Customization – Control colors, shininess/metalness (0-1 scale)
- Lighting Control – Adjustable light intensity (0-10 range) with ambient + directional lighting
- Shadow Support – Enable realistic shadows for your 3D models
- Camera Controls – Option to enable or disable user camera interaction
- Multiple Loading Animations – Choose from Spinner, Progress Bar, 3D Cube, or None
- Responsive Design – Automatic canvas resizing for all screen sizes and devices
- Mobile-Friendly – Touch controls for rotation, zoom, and pan on tablets and phones
- Accessibility Ready – ARIA labels, alt text support, and keyboard navigation
- WordPress Media Library – Upload models directly through standard media uploader
- Dimension Controls – Set custom width/height with multiple units (px, %, em, rem, vw, vh)
- Translation Ready – Full internationalization support (text domain: press3d)
Perfect for:
- Product showcases and e-commerce 3D product views
- Architectural visualization and real estate
- Educational content and scientific models
- Engineering and CAD model presentations
- 3D printing file previews
- Medical and anatomical models
- Art and sculpture portfolios
- Game assets and character models
Source Code
The source code for this plugin is available in the src and assets/src directories.
Screenshots
Gutenberg block with live 3D preview in editor
Creating shortcodes in Media Library Attachment Details modal
Shortcode usage in Classic Editor
Settings page with default options (color, zoom, dimensions, loading animation)
What 3D model formats are supported?
Press3D supports four major 3D formats: STL, OBJ, GLB, and GLTF. GLB (binary glTF) is recommended for best web performance and file size.
Is the plugin compatible with the Gutenberg block editor?
Yes! Press3D includes a native Gutenberg block with live preview, full inspector controls, and real-time 3D viewer in the editor.
Can I use shortcodes instead of blocks?
Absolutely! Use the shortcode [press3d id="123" version="2"] where 123 is your media attachment ID. Shortcodes also support versioning with the version parameter: [press3d id="123" version="2"].
Does it work with Classic Editor?
Yes, the shortcode works in both Gutenberg and Classic Editor.
What is the recommended file size for 3D models?
For optimal performance and page load times, we recommend keeping model files under 10MB. Consider using GLB format with compression for larger models.
Can I customize the appearance of the 3D viewer?
Yes! You can control:
– Model color
– Light intensity (0-10 scale)
– Shininess/metalness (0-1 scale, affects roughness and metalness)
– Auto-rotate speed and direction (-10 to +10)
– Loading animation style (Spinner, Progress Bar, 3D Cube, or None)
– Viewer dimensions (width/height with multiple units)
Does the camera position save?
Yes! Press3D saves the exact camera state (position, target, up vector) so when you refresh the page, the 3D model appears exactly as you positioned it.
Is Three.js library included?
Yes, the Three.js library is bundled with the plugin and optimized for WordPress.
Are there any server requirements?
You need PHP 7.4 or higher and WordPress 6.6 or higher. The plugin uses standard WordPress APIs and doesn’t require special server configurations.
Does it work on mobile devices?
Yes! Press3D is fully responsive with touch controls for rotation, zoom, and pan on tablets and smartphones.
Can I use this plugin commercially?
Yes, Press3D is licensed under GPLv2 or later, which allows commercial use.
Is the plugin accessible?
Yes, Press3D includes ARIA labels, alt text support for screen readers, keyboard navigation, and semantic HTML structure.
Why are my STL models rotated differently than in other viewers?
Press3D automatically rotates STL models -90° around the X-axis to match the Y-up orientation standard used by most 3D software.
Can I set default settings for all models?
Yes! Go to Settings → Press3D where you can configure:
– Default model color
– Default zoom level
– Default canvas width and height
– Loading animation style (Spinner, Progress Bar, 3D Cube, or None)
How do I access model metadata programmatically?
Press3D exposes model metadata via WordPress REST API.
ChangeLog
1.1.0
- Security update: Fixed Stored XSS vulnerability in 3D Model block (CVE-2026-1985).
- Added global default settings for Zoom, Width, and Height.
- Added Czech (cs_CZ) and German (de_DE) translations.
1.0.2
- Fixed remaining issues from the plugin review (escaping).
- Removed unused methods from Utils class.
1.0.1
- Fixed issues from the plugin review (remote assets, security).
1.0.0
