View Plugins
Back to Blog
TutorialMarch 7, 202614 min read

Photo Sphere Viewer: The Complete Guide to 360° Panoramas, Virtual Tours & 360 Video on WordPress

Learn how to embed interactive 360° panoramas, build multi-scene virtual tours, and play immersive 360° videos on your WordPress site — no coding required.

🌐

Photo Sphere Viewer: The Complete Guide to 360° Panoramas, Virtual Tours & 360 Video on WordPress

Static images can only show so much. When you need to showcase a hotel room, a real estate property, a travel destination, or a museum exhibit, a flat photo leaves out most of the experience. That's where 360° content comes in.

Photo Sphere Viewer is a WordPress plugin that lets you embed interactive 360° panoramic images, multi-scene virtual tours, and immersive 360° videos on any page — using Elementor, Gutenberg, or shortcodes. No coding required.

This guide covers everything the plugin offers, from basic panorama embedding to advanced virtual tour building and 360° video playback.

Why 360° Content Matters

Interactive 360° content is no longer a novelty. It's becoming a standard expectation in several industries:

  • Real estate listings with virtual tours receive 87% more views than those without
  • Hotels using 360° room previews see higher booking conversion rates
  • Travel websites with immersive panoramas keep visitors engaged 5–10x longer than static galleries
  • E-commerce stores with 360° product views report lower return rates

    • The key advantage is simple: visitors can explore a space or product on their own terms, looking wherever they want. That builds confidence and trust in ways that curated photo angles cannot.

    360° Panorama Viewer

    The core feature of the plugin is the panorama viewer. Upload any equirectangular panorama image (JPEG or PNG) and it renders as a fully interactive 360° scene.

    What Visitors Can Do

  • Drag to explore with mouse or touch gestures
  • Pinch to zoom on mobile devices
  • View in fullscreen mode
  • See captions and navigation controls in the navbar

    • What You Can Configure

  • **Starting Position**: Set the default yaw (horizontal, -180° to 180°) and pitch (vertical, -90° to 90°) so visitors see exactly what you want them to see first
  • **Auto-Rotation**: Enable automatic rotation with adjustable delay and speed — great for catching attention on landing pages
  • **Canvas Background**: Set a custom background color behind the panorama while it loads
  • **Zoom Limits**: Control how far visitors can zoom in or out
  • **Movement Speed**: Adjust how responsive the drag controls feel
  • **Mouse & Touch Options**: Enable or disable mouse wheel zoom, drag movement, two-finger touch, Ctrl+scroll, and cursor capture

    • The viewer works with any equirectangular image. That includes photos from Google Street View cameras, Ricoh Theta, Insta360, Samsung Gear 360, or any similar 360° camera. If your image is in equirectangular format, it works out of the box.

    Virtual Tour Builder

    Single panoramas are useful, but virtual tours are where the plugin really shines. You can create multi-scene tours where visitors navigate between linked panoramas using 3D arrow hotspots.

    How It Works

    1. Add multiple panorama scenes to your tour

    2. Link scenes together with 3D navigation arrows

    3. Set a starting position for each scene

    4. Visitors click arrows to "walk" between scenes

    This is the same approach used by Google Street View, but running directly on your WordPress site with your own imagery.

    Use Cases for Virtual Tours

    **Real Estate**: Create full property walkthroughs. Start in the entrance, let visitors navigate to the kitchen, bedrooms, backyard — all within a single embedded tour. This is especially valuable for remote buyers or international clients.

    **Hotels & Resorts**: Show the lobby, different room types, the pool area, and restaurant. Guests can explore before booking, which builds confidence and reduces cancellations.

    **Museums & Galleries**: Let remote visitors walk through exhibits. Link gallery rooms together so people can browse at their own pace.

    **Campus Tours**: Universities and schools can create virtual campus tours for prospective students who can't visit in person.

    **Event Venues**: Wedding venues, conference halls, and event spaces can showcase their facilities with self-guided virtual tours.

    Pro Features for Tours

    The Pro version adds two important tour features:

  • **Scene Gallery Thumbnail Bar**: A visual bar showing thumbnails of all scenes, letting visitors jump directly to any location
  • **Compass Overlay Widget**: Shows directional orientation within the scene, helping visitors understand where they are in the space

    • 360° Video Player

    Beyond static panoramas, the plugin supports 360-degree video playback. Upload a 360° video and visitors can look around while the video plays — the same experience as 360° videos on YouTube, but embedded directly on your site.

    Supported Features

  • MP4 and common web video formats
  • Play/pause, seek, and volume controls built into the navbar
  • Interactive look-around while video plays
  • Works in both Elementor widget and [psv_video] shortcode

    • Pro Video Features

  • **Autoplay**: Videos start playing automatically (muted, per browser requirements)
  • **Loop Playback**: Videos restart automatically when they end

    • 360° video is ideal for immersive travel content, event recordings, construction progress documentation, and cinematic VR experiences.

    Gallery Plugin

    The Gallery Plugin adds a thumbnail gallery bar below the viewer. Visitors can see all available panoramas and click to switch between them instantly.

  • Configurable thumbnail size
  • Click-to-navigate between panoramas
  • Auto-hide on click option
  • Works with both single panoramas and tour scenes

    • This is particularly useful when you have multiple panoramas on a single page — for example, showing different rooms of a property or different angles of a product.

    Three Ways to Embed

    Photo Sphere Viewer gives you three methods to add 360° content to your site:

    1. Elementor Widgets

    If you use Elementor, you get dedicated widgets:

  • **Photo Sphere Viewer** — For single panoramas
  • **PSV Virtual Tour** — For multi-scene tours
  • **PSV 360° Video** — For 360° video playback

    • Drag the widget into your layout, upload your content, and configure settings visually. All options are available in the Elementor sidebar panel.

    2. Gutenberg Block

    Insert the Photo Sphere Viewer block in the block editor. Upload your panorama and configure options from the sidebar panel. Clean and simple.

    3. Shortcodes

    Use the built-in Shortcode Builder from the admin menu to visually create shortcodes, or write them manually:

    Basic panorama:

    [psv image="panorama.jpg" width="100" height="80"]

    Virtual tour:

    [psv_tour] with scene configuration

    360° video:

    [psv_video src="360-video.mp4"]

    Shortcodes work anywhere — posts, pages, widget areas, and WooCommerce product descriptions.

    Customizable Navbar Controls

    The viewer navbar is fully configurable. You can toggle individual controls on or off:

  • **Caption**: Display a text caption for the current scene
  • **Zoom**: In/out zoom buttons
  • **Fullscreen**: Expand to full browser window
  • **Autorotate**: Let visitors toggle auto-rotation
  • **Download**: Allow panorama image download

    • You also get style controls for navbar background color, caption color, and typography. This lets you match the viewer's interface to your site's design.

    Pro Features Overview

    The free version is genuinely capable — it includes the full panorama viewer, virtual tours with 3D arrows, 360° video playback, caption navbar, and the shortcode builder.

    Pro unlocks advanced capabilities:

  • **Zoom, Fullscreen, Download & Autorotate Navbar Controls**: Give visitors full control over their viewing experience
  • **Gallery Plugin**: Thumbnail gallery bar for switching between panoramas
  • **Compass Overlay Widget**: Directional orientation display
  • **Gyroscope Support**: Mobile users explore by physically moving their device — a VR-like experience without a headset
  • **Visible Range Restriction**: Limit horizontal and vertical viewing angles to control exactly what visitors can see
  • **Video Autoplay & Loop**: 360° videos play automatically and can loop continuously
  • **Scene Gallery Thumbnail Bar**: Visual scene selector for virtual tours
  • **Priority Email Support**: Direct access to the WPXERO support team

    • Performance & Technical Details

    The plugin is built with performance in mind:

  • Lightweight, optimized build with minimal footprint
  • Assets only load on pages where the viewer is used
  • Smooth 60fps rendering on modern devices
  • Touch-optimized for mobile performance
  • No jQuery dependency

    • Compatibility

  • WordPress 5.0 or higher (tested up to 6.9)
  • PHP 7.0 or higher
  • Works with all major themes (Astra, Kadence, GeneratePress, Divi, OceanWP, Avada, Flatsome)
  • WooCommerce compatible
  • Elementor and Gutenberg supported

    • Setting It Up

    Installation

    1. Install from the WordPress plugin directory (search "Photo Sphere Viewer") or upload the plugin ZIP file

    2. Activate through the Plugins menu

    3. Start embedding 360° content using Elementor widgets, Gutenberg blocks, or the Shortcode Builder

    Quick Start: Your First Panorama

    1. Open a page in Elementor or the block editor

    2. Add the Photo Sphere Viewer widget/block

    3. Upload an equirectangular panorama image

    4. Adjust the starting position if needed

    5. Publish

    That's it. Your visitors can now drag, zoom, and explore the panorama interactively.

    Quick Start: Your First Virtual Tour

    1. Add the PSV Virtual Tour widget or use the [psv_tour] shortcode

    2. Add your first scene — upload a panorama and give it a name

    3. Add additional scenes

    4. Link scenes together with navigation arrows

    5. Set starting positions for each scene

    6. Publish

    Visitors will see the first scene and can click 3D arrows to navigate between locations.

    Real-World Examples

    Real Estate Agency

    A property listing page with a virtual tour of each listing. The tour starts in the front entrance, with arrows leading to the living room, kitchen, each bedroom, and the backyard. The scene gallery thumbnail bar lets buyers jump directly to any room. Result: more qualified inquiries from serious buyers who've already "visited" the property.

    Boutique Hotel

    Each room type has a 360° panorama on its booking page. The hotel lobby and common areas have a linked virtual tour. A 360° video shows the rooftop terrace at sunset. Result: higher booking confidence and fewer "the room didn't match my expectations" complaints.

    Online Furniture Store

    WooCommerce product pages for premium furniture include 360° panoramas showing the piece in a styled room setting. Customers can look around the room to see how the furniture fits in context. Result: lower return rates and higher average order values.

    University Admissions

    The admissions page features a comprehensive campus virtual tour. Prospective students can walk through the library, lecture halls, dormitories, sports facilities, and campus grounds. Result: increased application rates from out-of-state and international students.

    Tips for Better 360° Content

    Image Quality

  • Use the highest resolution your camera supports — 360° images are stretched across a full sphere, so you need more pixels than a standard photo
  • Minimum recommended: 4096 x 2048 pixels. Ideal: 8192 x 4096 or higher
  • JPEG format with 85-90% quality balances file size and visual quality

    • Shooting Tips

  • Use a tripod with a panoramic head for sharp, aligned stitching
  • Shoot in consistent lighting — avoid mixed indoor/outdoor light if possible
  • Remove the tripod from the nadir (bottom) in post-processing for a cleaner look
  • Take multiple exposures if the scene has high dynamic range

    • Starting Position

    Think about what visitors should see first. For a hotel room, start facing the bed and window view. For a real estate kitchen, start facing the countertops and appliances. The starting position shapes the first impression.

    Tour Navigation

    Place navigation arrows where they make spatial sense. If the door to the next room is on the left, put the arrow on the left. This creates an intuitive "walking" experience that matches the actual space.

    Free vs Pro: Which Do You Need?

    The free version covers the essentials:

  • Full 360° panorama viewer with drag, zoom, and touch controls
  • Virtual tours with unlimited scenes and 3D navigation arrows
  • 360° video playback with play/pause, seek, and volume
  • Caption navbar
  • Shortcode builder
  • Elementor widgets and Gutenberg block
  • Starting position controls
  • Auto-rotation
  • Canvas background color

    • Upgrade to Pro if you need:

  • Advanced navbar controls (zoom, fullscreen, download, autorotate buttons)
  • Gallery thumbnail bar for panoramas and tours
  • Compass overlay widget
  • Gyroscope support for mobile VR-like experiences
  • Visible range restriction
  • Video autoplay and loop
  • Scene gallery thumbnail bar
  • Priority email support

    • For most personal sites and small businesses, the free version is a great starting point. Real estate agencies, hotels, and professional photography studios will likely benefit from Pro features — especially the gallery bar, gyroscope support, and visible range restriction.

    Conclusion

    Photo Sphere Viewer brings professional-grade 360° content to WordPress without complexity. The panorama viewer, virtual tour builder, and 360° video player cover the three main types of immersive content, and the Elementor/Gutenberg/shortcode integration means you can embed them anywhere.

    If you're in real estate, hospitality, photography, travel, education, or e-commerce, 360° content isn't just a nice-to-have anymore — it's becoming what customers expect. Photo Sphere Viewer makes it accessible without requiring a developer or a massive budget.

    [Get started with Photo Sphere Viewer](/plugins/photo-sphere-viewer)

    **Primary Keyword:** 360 panorama WordPress plugin

    **Secondary Keywords:** Photo Sphere Viewer, virtual tour WordPress, 360 video WordPress, WordPress panorama viewer, 360° image WordPress, interactive panorama plugin

    Common Questions