Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
JavaScript image gallery for mobile and desktop, modular, framework independent
JavaScript CSS HTML
Failed to load latest commit information.
dist v4.0.8 bump / js build
src Custom PID support
website docs upd
.gitignore build & cleanup
.jshintrc 4.0.6 build
.travis.yml travis
Gruntfile.js Fix file and folder permissions
LICENSE :christmas_tree: Update
bower.json docs upd
package.json v4.0.8 bump / js build
photoswipe.json v4.0.8 bump / js build

PhotoSwipe Repository

Build Status devDependency Status Donate Flattr

JavaScript image gallery for mobile and desktop.

Optionally, install via Bower: bower install photoswipe.

Location of files

  • Generated PhotoSwipe JS, CSS files, SVG & PNG sprites are in the dist/ folder.
  • Source files are in the src/ folder.
  • Files for the website (demo & documentation) are in the website/ folder.
  • The documentation itself is in website/documentation/.

Plugins / extensions / addons

Coded something useful? Email me and I’ll post a link to it here.


To compile PhotoSwipe by yourself, first make sure that you have Node.js, Grunt.js, Ruby and Jekyll installed, then:

1) Clone the repository

git clone

2) Go inside the PhotoSwipe folder that you fetched and install Node dependencies

cd PhotoSwipe && npm install

3) Now simply run grunt to generate the JS and CSS files in the dist folder and the site in the _site/ folder.



  • Run grunt watch to automatically rebuild files when you change files in src/ or in website/.
  • Run grunt nosite to just build the JS and CSS files (output is folder dist/).
  • Run grunt pswpbuild to build just JS files. Param --pswp-exclude allows to exclude modules, for example grunt pswpbuild --pswp-exclude=history will exclude history module.

Using PhotoSwipe?

If you’ve used PhotoSwipe in some interesting way, or on the site of a popular brand, I’d be very grateful if you shoot me a link to it.


Script is licensed under MIT license with one exception: Do not create a public WordPress plugin based on it, as I will develop it. If you need to use it for a public WordPress plugin right now, please ask me by email first. Thanks!

Attribution is not required, but much appreciated, especially if you’re making a product for developers.


PhotoSwipe 4.0+ is developed by Dmitry Semenov. But initially script was created in 2011 by Code Computerlove, a digital agency in Manchester, they passed on development in March 2014. You can view source and documentation of old PhotoSwipe (<4.0) in history of this repo.

Something went wrong with that request. Please try again.