Photo Sphere Viewer
Display interactive 360° sphere panoramas in any browser. Built on Three.js with a rich plugin ecosystem.
Why Photo Sphere Viewer?
Photo Sphere Viewer is a battle-tested, modular JavaScript library for embedding 360° panoramic viewers in web applications. It supports multiple image formats, offers rich interactivity, and is fully extensible through its plugin architecture.Multiple Formats
Supports equirectangular, cubemap, tiled panoramas, videos, and dual-fisheye images out of the box.
Rich Plugin System
Extend functionality with 14+ official plugins: markers, virtual tours, maps, galleries, gyroscope, and more.
TypeScript First
Fully typed API with strongly typed events, adapters, and plugins for an excellent developer experience.
Three.js Powered
WebGL rendering via Three.js delivers smooth 60fps navigation with hardware acceleration.
Modular Architecture
Install only what you need with scoped npm packages under
@photo-sphere-viewer/*.Customizable
Override SCSS variables to match your brand, customize the navbar, and configure every interaction.
Quick Install
Your First Panorama
Explore the Docs
Getting Started
Install Photo Sphere Viewer and create your first panorama viewer in minutes.
Configuration
Explore all viewer options, from zoom limits to keyboard actions and caching.
Adapters
Load cubemaps, tiled panoramas, videos, and more with specialized adapters.
Plugins
Add markers, virtual tours, maps, galleries, and more with the plugin system.
Events & Methods
Programmatically control the viewer and react to user interactions.
Writing a Plugin
Build your own plugin to extend Photo Sphere Viewer’s functionality.