Guides
The documentation lists what every option does; these articles show how the options work together on real pages. Each guide ends with a live gallery that uses the settings it describes.
Migrating from 1.x to 2.x
What changed when the library dropped its jQuery dependency, and how to move an existing site across.
Read the guide →
Working with captions
Titles, alt text, data attributes and element text as caption sources, plus placement and timing.
Read the guide →
Dynamic galleries and refresh()
Keep the lightbox in sync when photos arrive through Ajax, infinite scroll or a single-page app.
Read the guide →
Touch, swipe and zoom settings
Tune swipe distance, pinch and double-tap zoom, keyboard control and page scrolling.
Read the guide →About these guides
Each article starts from a concrete situation: a site moving away from the old jQuery plugin, captions that live in the markup instead of a title attribute, photos that arrive after the first page load, or a portfolio that should zoom further on a phone. It explains which options matter, shows the code and ends with a live gallery using exactly that configuration, so you can try the behaviour before copying it.
The code in the guides uses the standalone build and plain JavaScript. It works the same way with the jQuery variant: replace new SimpleLightbox(selector, options) with $(selector).simpleLightbox(options) and keep the options object as it is.
For content management systems, the WordPress and TYPO3 pages cover loading the files, the markup produced by the editors and grouping the images of each gallery.