πΈ Photo Sphere Viewer is a powerful WordPress plugin for rendering 360Β° panoramas from various image and video formats, including JPEG, PNG, and MP4. With compatibility for both Elementor Widgets and Gutenberg Blocks, you can display immersive panoramic experiences anywhere on your WordPress site, whether on posts, pages, widget areas, or WooCommerce product pages. With no coding skills required, itβs easy for anyone to enhance their site with captivating 360Β° views.
π― Features
- Multiple Display Options: Use Elementor Widget or WordPress Shortcode
- Customizable Controls: Adjust field of view, zoom, dimensions, and more
- Responsive and Interactive: Works seamlessly on touch screens and desktops
- Compatibility: Works with the latest WordPress and Elementor versions
- Easy Installation: Quickly add and configure your 360Β° panoramas
π§ How to Use
1. Using Elementor Widget
- Open the Elementor editor and insert the Photo Sphere Viewer widget.
- Customize settings in the Content and Style tabs:
- Content Tab: Adjust height, width, captions, and more.
- Controls: Set field of view, zoom levels, and enable/disable specific actions.
- Advanced Controls: Control speeds for mouse, movement, and zoom interactions.
- Style Tab: Customize appearance with color, border, and typography settings.
2. Using WordPress Shortcode
Use the Photo Sphere Viewer shortcode directly in the Gutenberg editor (Shortcode block) or anywhere shortcodes are supported.
Basic usage:
[photo_sphere_viewer]
Example with a few options:
[photo_sphere_viewer image="https://example.com/panorama.jpg" caption="Stunning Panorama" width="100" height="80"]
Examples with advanced options:
[photo_sphere_viewer image="https://example.com/pano.jpg" navbar="autorotate,download,caption,fullscreen" min_fov="30" max_fov="90" default_zoom_lavel="50" autorotate_delay="1500" autorotate_speed="20" fish_eye="no" mouse_wheel="yes" mousewheel_ctrl_key="no" mouse_move="yes" touch_move_two_fingers="yes" capture_cursor="no" move_speed="1" mouse_wheel_speed="1" zoom_button_increment="2" canvas_background="#333"]
All Shortcode Attributes (with defaults):
- image (string) β URL of the panorama image.
-
Default: plugin demo image
bryce-canyon-national-park.jpg.- caption (string) β Caption text displayed in the viewer.
-
Default: βFrom shortcodesβ.
- navbar (comma-separated list) β Controls shown in the toolbar.
- Default:
autorotate,download,caption,fullscreen - Allowed items:
autorotate,download,caption,fullscreen.- width (number) β Viewer width as percentage of the container.
- Default:
100(interpreted as100%).- height (number) β Viewer height in viewport height units.
- Default:
80(interpreted as80vh).- min_fov (number) β Minimum field of view.
- Default:
30.- max_fov (number) β Maximum field of view.
- Default:
90.- default_zoom_lavel (number) β Initial zoom level.
- Default:
50.- default_longitude (number) β Initial longitude (radians or degrees depending on core library config).
- Default:
0.- default_latitude (number) β Initial latitude.
- Default:
0.- longitude_range (number|array) β Limit horizontal range. Use
0for no limit.
- longitude_range (number|array) β Limit horizontal range. Use
- Default:
0.- latitude_range (number|array) β Limit vertical range. Use
0for no limit.
- latitude_range (number|array) β Limit vertical range. Use
- Default:
0.- autorotate_delay (number) β Delay in ms before auto-rotate starts. Empty disables.
- Default: empty (disabled).
- autorotate_speed (number) β Auto-rotate speed; higher is faster.
- Default:
10(internally scaled to the libraryβs expected value).- fish_eye (yes|no) β Enable fisheye effect.
- Default:
no.- mouse_wheel (yes|no) β Enable zoom with mouse wheel.
- Default:
yes.- mousewheel_ctrl_key (yes|no) β Require Ctrl key for mouse wheel.
- Default:
no.- mouse_move (yes|no) β Enable mouse move (drag) controls.
- Default:
yes.- touch_move_two_fingers (yes|no) β Require two fingers to move on touch.
- Default:
yes.- capture_cursor (yes|no) β Capture cursor while interacting.
- Default:
no.- move_speed (number) β Move speed multiplier.
- Default:
1.- mouse_wheel_speed (number) β Mouse wheel zoom speed multiplier.
- Default:
1.- zoom_button_increment (number) β Zoom step for +/- buttons.
- Default:
2.- canvas_background (CSS color) β Viewer canvas background color.
- Default:
#333.
Notes:
β Width and height are interpreted as % and vh respectively by the viewer.
β Boolean-like attributes accept yes or no.
β If autorotate_delay is empty, auto-rotate is disabled regardless of autorotate_speed.
π Installation
- Download the plugin as a .zip file.
- In the WordPress Admin Panel, navigate to Plugins > Add New.
- Click on Upload Plugin, choose the .zip file, and click Install Now.
- After installation, click Activate to enable the plugin on your site.
1.3.3 [01st October 2025]
- WordPress and Elementor latest version compatibility issue fixed
- Upgrade the documentation of the plugin
1.3.2 [01st May 2025]
- WordPress and Elementor latest version compatibility issue fixed
1.3.1 [21st December 2024]
- System Improved.
- Compatibility updates for the latest WordPress and Elementor versions
1.3.0 [09th October 2024]
- Compatibility updates for the latest WordPress and Elementor versions
1.2.0 [09th October 2023]
- WordPress and Elementor latest version compatibility issue fixed
1.1.0 [15th March 2023]
-Elementor latest version compatibility issue fixed
1.0.1 [15th May 2022]
- Shortcode Features Added
1.0.0 [06th February 2022]
- Initial Release