WordPress.org

Plugin Directory

Photo Sphere Viewer – 360° Panorama, Virtual Tour, 360 Video & AR 3D Model Viewer

Photo Sphere Viewer – 360° Panorama, Virtual Tour, 360 Video & AR 3D Model Viewer

Description

🌐 One plugin, four ways to show something in 360°

Photo Sphere Viewer started as a simple way to drop an equirectangular panorama into a WordPress page without wrestling with iframes or third-party embed accounts. It’s grown into four viewers in one plugin: panoramas, multi-scene virtual tours, 360° video, and AR-ready 3D models (.glb / .gltf). Add any of them through Elementor, Gutenberg, or a shortcode — whatever your site already uses.

If you shoot with a DJI drone, Ricoh Theta, Insta360, or anything that outputs a stitched equirectangular image, it’ll load. No proprietary format, no vendor lock-in.

Upgrade to Pro

📷 Built with real camera gear in mind

A lot of 360 plugins are built by people who never touched a drone. This one wasn’t.

  • DJI Matrice and other drone panoramas — WordPress quietly re-compresses anything over 2560px into a -scaled.jpg since 5.3, which is fine for a blog photo and terrible for a 40MP aerial panorama. The plugin ships with its own ImageResolver that grabs the original upload instead, so fine detail doesn’t turn to mush.
  • Ricoh Theta, Insta360, GoPro MAX, Qoocam, Kandao — any properly stitched equirectangular JPEG or PNG just works, no special export needed.
  • Google Street View and Android Photo Sphere — same deal, drop the file in and go.
  • Gyroscope viewing (Pro) — point a phone around and the panorama follows, VR-headset style, over HTTPS.

🧭 Four viewers

Panorama viewer — the original use case. Upload an equirectangular JPEG/PNG, visitors drag, pinch and zoom on desktop or mobile. Set field of view, zoom limits, movement speed, auto-rotation, a starting yaw/pitch, fullscreen, and a caption navbar with free zoom and download buttons.

Virtual tour builder — string together as many scenes as you want, connected with 3D arrow hotspots. Each scene gets its own starting angle and caption, and you pick which one loads first. Good fit for real estate walkthroughs, hotel tours, museum floor plans. Pro adds a scene gallery bar, a compass overlay, and the full premium navbar (move, fullscreen, autorotate, description, zoom, download).

360° video player — same dragging/looking-around interaction, but for an equirectangular MP4 instead of a still image. Play/pause, seek, volume. Pro unlocks muted autoplay and loop.

AR 3D model viewer — embeds a .glb/.gltf model via Google’s <model-viewer>, with an AR button on phones that support it. Point it at a WordPress Media Library file or an external URL, set a poster image, auto-rotate, shadow intensity and alignment. Pro adds HDR environment lighting, a skybox background, custom camera orbit, and the ability to lock zoom/tap-to-rotate if you’re building a fixed product showcase.

🧩 Add it wherever you build pages

  • Elementor — four separate widgets (Photo Sphere Viewer, PSV Virtual Tour, PSV 360° Video, AR 3D Viewer), each of which can be switched off individually from the admin panel if you don’t need it cluttering the widget list.
  • Gutenberg block — native block editor support with live preview. (coming soon)
  • Shortcode Builder — a visual admin screen that spits out [psv], [psv_tour], [psv_video], and [psv_ar] shortcodes you can paste into a WooCommerce product description, a theme widget area, or anywhere else shortcodes render.

What else is in the box

  • Fully responsive, touch-optimized drag/pinch on mobile
  • Navbar buttons toggle individually — zoom, caption, fullscreen, autorotate, download
  • Style controls for navbar background, caption color, typography, alignment
  • Width/height in px, %, vh or vw
  • Default yaw (-180° to 180°) and pitch (-90° to 90°)
  • Custom canvas background color
  • Mouse-wheel zoom, drag movement, two-finger touch, Ctrl+scroll, cursor capture and fisheye toggles
  • Original-resolution image loading on by default (use_original=yes) for shortcodes
  • Built on Vite, so the frontend bundle stays small
  • Translation-ready (text domain photo-sphere-viewer, loads from /languages/)
  • A clean shortcode API and Elementor widget hooks if you’re extending it yourself

Who actually uses this

Real estate agents doing property walkthroughs, hotels and vacation rentals showing off rooms before booking, 360° photographers building portfolios, museums and campuses doing self-guided tours, WooCommerce stores adding 360° product views or AR models, architects showing before/after spaces, and drone pilots who just want their DJI panoramas to not look blurry on the web.

Plays nicely with

Elementor, Elementor Pro, Gutenberg, WooCommerce, Yoast SEO, Rank Math, WPML, Polylang, and the usual caching suspects — WP Rocket, LiteSpeed Cache, W3 Total Cache. Tested against DJI Matrice/Mavic, Ricoh Theta, Insta360, GoPro MAX, Qoocam, Kandao, and Google Street View exports.

How It Works

Using Elementor

Open the Elementor editor, search the widget panel for Photo Sphere Viewer, PSV Virtual Tour, PSV 360° Video, or AR 3D Viewer, drag one into your layout, then upload your image/video and set the navbar and styling options.

Using Gutenberg

Insert the Photo Sphere Viewer block, upload a panorama, configure it from the sidebar.

Using Shortcodes

Build one visually with the Shortcode Builder in the admin menu, or write the attributes by hand if you know what you’re doing.

Screenshots

Installation

  1. Upload the photo-sphere-viewer folder to /wp-content/plugins/, or install it straight from the WordPress plugin directory.
  2. Activate it under Plugins.
  3. Add 360° content through the Elementor widget, the Gutenberg block, or the shortcode builder under the Photo Sphere Viewer admin menu.

FAQ

What image and video formats are supported?

Equirectangular JPEG or PNG for panoramas, MP4 (or most common web video formats) for 360 video, and .glb/.gltf for the AR viewer.

Do I need Elementor to use this?

No — it works the same whether you’re on Elementor, Gutenberg, or plain shortcodes. Shortcodes in particular go pretty much anywhere: posts, pages, widget areas, theme builders, even WooCommerce product descriptions.

My drone panoramas look soft/blurry once uploaded — why?

That’s WordPress doing it, not the plugin. Since 5.3, anything over 2560px on its long edge gets saved as a -scaled.jpg and served instead of your original. The plugin’s ImageResolver bypasses that and loads the real upload — shortcodes default to use_original=yes, and Pro adds a toggle for it directly in the Elementor widget.

Does it support Ricoh Theta, Insta360, GoPro MAX, or Google Street View exports?

Yes, along with Qoocam, Kandao, and Android Photo Sphere XMP captures. Anything that’s a properly stitched equirectangular image works without conversion.

Is it usable on a phone?

Yes — drag-to-look, pinch-to-zoom, two-finger gestures all work on touch. Pro adds gyroscope mode so tilting the phone moves the view, which needs HTTPS to work.

Can a tour have more than one scene?

As many as you want. Link them with 3D arrow hotspots, give each one its own caption and starting angle, and choose which scene opens first. Works in both the Elementor PSV Virtual Tour widget and the [psv_tour] shortcode.

What about 360 video?

The PSV 360° Video widget or [psv_video] shortcode handle that — play/pause, seek, volume in the navbar. Autoplay and loop are Pro-only.

Can I put a 3D/AR model on a page?

Yes, through the AR 3D Viewer widget or [psv_ar] shortcode. It renders .glb/.gltf files via Google’s <model-viewer> and shows an AR button on phones that support it. Pro adds HDR lighting, a skybox, custom camera orbit, and locks for zoom/tap-to-rotate — useful if you’re building a product configurator and don’t want visitors spinning things by accident.

How do I change the starting view angle?

Every panorama and tour scene has a starting yaw (-180° to 180°) and pitch (-90° to 90°), set in the Elementor controls or via the default_yaw/default_pitch shortcode attributes.

Does it work on WooCommerce product pages?

Yes, through shortcodes or Elementor templates — a reasonable alternative to paying for a hosted 360-product-viewer service.

Will this slow my site down?

It shouldn’t — the frontend is built with Vite and only loads on pages that actually use a viewer. No conflicts we’re aware of with WP Rocket, LiteSpeed Cache, or W3 Total Cache.

Is it translatable?

Yes, text domain photo-sphere-viewer, translations load from /languages/. Works with WPML and Polylang.

What do I get with Pro that I don’t get free?

Free already includes all four viewers, Elementor/Gutenberg/shortcode support, and the original-resolution image loader. Pro adds the scene gallery bar, compass overlay, gyroscope, visible-range restriction, the full premium navbar on tour and video (move/fullscreen/autorotate/description/zoom/download), video autoplay/loop, the advanced AR options (HDR, skybox, camera orbit, interaction locks), an in-widget original-resolution toggle, and priority email support. Full breakdown at the pricing page.

Can I get a refund on Pro?

There’s a 30-day money-back guarantee if it’s not a fit.

Where do I get help?

Free users can post on the WordPress.org support forum. Pro license holders get direct email support from the WPXERO team.

Reviews

December 2, 2025 1 reply
it got the JEW Update on 29the of Nov, Autorotation was free, now they charge you Money for something which was implemented allready since months. the last Update is only there to get some schekels however before i was a big fan of this plugin
Read all 2 reviews

Contributors & Developers

“Photo Sphere Viewer – 360° Panorama, Virtual Tour, 360 Video & AR 3D Model Viewer” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

2.2.4 [July 31, 2026]

  • Added: Proper uninstall handling — fires Freemius uninstall event for the free plugin on delete
  • Removed: “Coming Soon” Gutenberg card from the admin Integration screen
  • Improved: Updated Freemius SDK to 2.13.4

2.2.3 [June 06, 2026]

  • Fixed: Shortcode panoramas failing on pages without jQuery
  • Improved: Asset loading and Vite dev-server detection
  • Improved: Centralized Pro add-on detection
  • Improved: Updated Elementor widget icons
  • Improved: Code cleanup across widgets and shortcode manager

2.2.2 [May 22, 2026]

  • Improved: improve plugin performance and stability
  • Fixed: various minor bug fixes and stability improvements

2.2.1 [May 20, 2026]

  • Fixed: High-resolution panorama detail loss by loading original images instead of scaled versions
  • Improved: stability and performance

2.2.0 [May 05, 2026]

  • Added: AR 3D Viewer — Elementor widget and [psv_ar] shortcode for .glb/.gltf models (model-viewer; optional AR on supported devices)
  • Improved: Admin dashboard UI — styling, navigation, and Upgrade page comparison table (including AR 3D Viewer Free vs Pro)
  • Improved: Tested compatibility through WordPress 7.0.0

2.1.1 [April 13, 2026]

  • Fixed: Compatibility with WordPress 7.0 and Elementor 4.0.1

2.1.0 [March 07, 2026]

  • Added: Virtual tour support for both widget and shortcode implementations
  • Added: 360° video playback support for widget and shortcode
  • Added: Gallery view support for widget and shortcode
  • Added: Starting position (yaw/pitch) controls for panorama and tour scenes
  • Improved: Compatibility with WordPress 6.9 and Elementor 3.35.5
  • Improved: Performance optimizations for faster panorama rendering
  • Fixed: Image display issue in Elementor 3.35.5 when placing widget inside columns
  • Fixed: Multiple Photo Sphere Viewer widgets rendering incorrectly within the same section in editor mode
  • Fixed: Duplicate frontend initialization on Elementor pages
  • Fixed: Various minor bug fixes and stability improvements

2.0.3 [February 13, 2026]

  • Fixed: Assets enqueue issue

2.0.2 [February 09, 2026]

  • Improved: Compatibility updates for WordPress 6.9 and Elementor 3.35.3
  • Improved: Performance improvements and bug fixes

2.0.1 [December 03, 2025]

  • Fixed: Upgrade notice issue
  • Added: Pro version pricing link
  • Improved: Compatibility with latest WordPress & Elementor versions

2.0.0 [November 29, 2025]

  • Added: Shortcode builder
  • Improved: Refactored codebase for improved performance
  • Added: Pro version

1.3.3 [October 01, 2025]

  • Improved: Compatibility updates
  • Improved: Documentation improvements

1.3.2 [May 01, 2025]

  • Improved: Compatibility updates

1.3.1 [December 21, 2024]

  • Improved: System improvements
  • Improved: Compatibility updates

1.3.0 [October 09, 2024]

  • Improved: Compatibility updates

1.2.0 [October 09, 2023]

  • Improved: Compatibility updates

1.1.0 [March 15, 2023]

  • Improved: Elementor compatibility update

1.0.1 [May 15, 2022]

  • Added: Shortcode feature

1.0.0 [February 06, 2022]

  • Initial release