PegasusCo 3D Previews for WooCommerce

PegasusCo 3D Previews for WooCommerce adds a 3D preview to WooCommerce product pages. Assign GLB models to simple products or individual variations so the preview follows the shopper’s selected size or finish. Shoppers can also switch variations inside an open preview. Optional USDZ files provide a prepared model for Apple’s Quick Look on supported devices.

Shoppers can rotate and zoom product models, then open AR on supported phones. Desktop shoppers can scan a QR code that keeps the selected product variation. The plugin bundles its viewer and QR code software locally. Sources for the bundled JavaScript libraries, including Google model-viewer 4.3.1, are listed in THIRD_PARTY_NOTICES.md; license notices are included in the plugin ZIP. The plugin does not require a vendor account, subscription, or a hosted model service. Product models are public files served by your WordPress site or configured CDN.

Dimensions and hotspots

The free plugin includes standard dimension labels, custom point measurements and hotspots with text, images, videos or links to published WooCommerce products.

Use Edit dimensions and hotspots in the product or variation settings. Click the model to place points, click Save in the editor, then Update the product or save the variation changes. Measurement lines overlay the model and are not occluded by its surfaces.

When viewing your store, you can now preview the 3D models. Models load when the preview opens. Custom catalogue templates must include one of these hooks or place the shortcode explicitly.

Guided camera views, animation controls, advanced rendering and lighting controls belong to the separate Pro plugin. Free hotspots and dimensions remain available when Pro is deactivated.

Please note: Browser annotations and controls are not transferred to native phone AR viewers.

Storewide settings

Open 3D Previews > Settings in the WordPress sidebar to manage variation display defaults, dimensions, hotspots, preview images and owner diagnostics across your store. One Augmented reality switch controls phone AR and the iPhone USDZ model fields. Each model must also be enabled and tested individually before shoppers can use AR.

Choose the View in 3D button text, appearance and placement. Automatic buttons can be enabled separately for product pages and shop or category pages. Turn off automatic placement and use the shortcode for manual placement, or disable all previews with the main switch.

In Product data > Variations > 3D preview controls, choose Automatic, Dropdown, Text buttons or Colour swatches for each attribute, then Update the product. These settings only affect the preview.

Usage analytics

Usage recording is on by default and can be paused in 3D Previews > Settings. Free analytics show store totals for Daily (today), 7 Days and 30 Days. Counts include successful 3D model loads and AR launch attempts. Store owner previews are excluded. Counts are interactions, not unique shoppers or confirmed completed native AR views.

The separate updated Pro add-on unlocks 90 Days, All time and By product reports. These choices are greyed out and marked Premium in Free. Free dimensions and hotspots remain available without Pro.

Model requirements

Self-contained GLB 2.0 (no external buffer/image URLs), maximum 100 MB and within your host’s lower upload limit. Keep production models substantially smaller for mobile downloads. Asset units must represent metres and its origin/orientation must suit the intended mounting surface.
USDZ is optional: without it, model-viewer generates an iOS file at launch. For controlled iPhone results, use a prepared and tested USDZ. Upload validation requires PHP ZipArchive, a stored/uncompressed archive, a USD root layer first, and permitted model/texture entries. Header/container checks do not validate artistic quality, anchoring, dimensions or every USD feature.

AR limitations

Android AR can use WebXR or Google’s Scene Viewer on a compatible ARCore phone with Google Play Services for AR; Scene Viewer also accepts vertical-placement requests for wall products. Unsupported devices retain 3D viewing. Android and iPhone wall placement depends on the model, device, and native viewer; ar-placement=”wall” does not guarantee wall anchoring. Check both on physical phones before enabling AR. AR does not simulate accurate mirror reflections or LED lighting in a room.

Compatibility and scope

Requires WordPress 6.8 or later, PHP 8.1 or later, and WooCommerce. Test compatibility with your theme, cache/optimization plugins, and devices. Product assignments use the classic WooCommerce product editor. Storefront previews support classic variation forms, the Add to Cart Form block, and the Add to Cart + Options block with its native variation pills or dropdowns. The preview is added beside these product blocks automatically; [your_ar_products] can also be placed in a Shortcode block. Add to Cart + Options follows storefront changes and offers model-supported choices inside the preview. Preview changes in this block do not alter the purchase selection; use Change size or finish to return to its storefront controls. QR links preserve the selected attributes. Block support is tested with WooCommerce 11.1.1; check customised themes and future WooCommerce releases. The experimental block-based admin product editor was retired in WooCommerce 11.0.

The free plugin does not create or convert 3D models, guarantee AR behaviour on a particular device, replace your product gallery, or include a vendor licensing service or hosted model service. Mirror reflections and room lighting are not simulated. Deactivation and uninstall preserve product model assignments and uploaded media.

Support

For help with installing the plugin, assigning models, or investigating a reproducible plugin issue, email [email protected]. Include your WordPress, WooCommerce, and PHP versions, the steps to reproduce the issue, and relevant screenshots. Do not email passwords, private customer information, or secret access links.

Support covers this plugin’s documented features. It does not include 3D modelling or model repair, custom theme development, general WordPress or hosting support, or guarantees that a particular model will work with every phone or AR viewer. Device and theme compatibility should be checked on your own store before enabling AR for shoppers.

Privacy

Plugin assets, QR generation and models are served by your WordPress site or configured media CDN. Usage recording is enabled by default and stores the calendar date, product ID and aggregate interaction counts in your WordPress database. It does not store visitor identifiers, IP addresses or tracking cookies, and local product analytics stay in your WordPress database. Optional count sharing is off by default. If enabled in 3D Previews > Settings, the plugin sends aggregate 3D open counts and a random delivery ID to PegasusCo once monthly. No product details, store URL, visitor identifiers or AR attempts are sent. PegasusCo may use shared counts in periodically updated public totals. Disable sharing to stop sending new counts. The receiving hosting service processes the store server connection information when handling requests. Counts are sent to https://www.pegasusco.com.au/api/plugins/usage. See privacy information and terms. Pause recording in 3D Previews > Settings. Existing counts are kept when recording is paused. Choosing native AR may launch the device’s Apple or Google viewer. Public models remain retrievable by visitors.