nanogallery2 academy

Get the most out of nanogallery2.

User guide

Learn how to configure and customize your gallery.


Content source

See how to define photos and videos.



Extend and manage nanogallery2 with javascript.


Live examples on Codepen

Quick tips

Lightbox - do not display image title

viewerToolbar: { display: false }
HTML markup
"viewerToolbar": { "display": false }

Gallery - single TAP on thumbnails

touchAnimation: false
HTML markup
"touchAnimation": false

Latest news

nanogallery2 v2.3.0 [Sep 26, 2018]
NEW new loading spinner with support of gif/png files with transparency
NEW new default lightbox image transition 'swipe2'
NEW optimized thumbnails lazy loading and display animation
FIXED Joomla3/Bootstrap2 Image Zoom In Bug
FIXED deep linking to image when only one album loaded
nanogallery2 v2.2.0 [May 25, 2018]
NEW new option 'eventsDebounceDelay' - thumbnail's lazy display fine tuning (response delay after resizing, rotation and scroll events)
NEW new internal NGY2Item object method 'delete' - deletes the current item
NEW new internal NGY2Item object method 'addToGOM' - adds the current item to the Gallery Object Modell
CHANGED 'thumbnailDisplayOutsideScreen' default value is now 'true'
FIXED issue on callbacks fnGalleryLayoutApplied, fnGalleryObjectModelBuilt, fnGalleryRenderStart (#121), galleryRenderEnd, fnShoppingCartUpdated, fnShoppingCartUpdated
FIXED thumbnails with a Single Quote wont load
FIXED Joomla/Bootstrap icon conflict - changed class in CSS file
FIXED custom theme using colorSchemeViewer not working
FIXED thumbnail effects 'labelSlideUp' and 'labelSlideDown'
FIXED thumbnail effects with CSS 2D/3D transformations
nanogallery2 v2.1.0 [Mar 5, 2018]
NEW API methods 'closeViewer', 'minimizeToolbar', 'maximizeToolbar', 'paginationPreviousPage', 'paginationNextPage', 'paginationGotoPage', 'paginationCountPages'
FIXED lightbox support for empty top-left or top-right toolbar
FIXED single touch to open thumbnail when no hover effect defined
FIXED option 'galleryMosaicL1' renamed to 'galleryL1Mosaic'
FIXED options 'touchAnimation' and 'touchAnimationL1'
nanogallery2 v2.0.0 [Nov 30, 2017]
NEW mosaic layout
NEW video support (Youtube, Vimeo and Dailymotion)
NEW image slider in thumbnail
NEW optimization for cascading layout
NEW new thumbnail alignement option
nanogallery2 v1.5.0 [Sept 7, 2017]
NEW swipe down to close lightbox
NEW thumbnail image dominant color in stacks
NEW thumbnail gradient color during image download
NEW lightbox option 'viewerImageDisplay' to manage image quality
NEW define multiple thumbnails per item
NEW enhanced lightbox image zoom and swipe
nanoPhotosProvider2 v1.1.0 [Aug. 1, 2017]
NEW new option to handle large images
NEW enhanced error management
NEW support Solaris web server
FIXED incorrect thumbnail size returned for grid layout
FIXED smisc minor bugs
nanogp v1.3.0 [Jul. 19, 2017]
NEW better privacy protection
nanogallery2 v1.4.0 [June 11, 2017]
NEW display thumbnail's images smoothly when fully downloaded
NEW gallery display animations
NEW tags support in nanoPhotosProvider2
NEW API functions to search in title and tags
NEW enhanced blurred image display during image download (thumbnails)
NEW enhanced thumbnails display animations
nanoPhotosProvider2 v1.0.0 [June 3, 2017]
NEW possibility to define the maximum image size used for display (full resolution version will be available for download)
NEW blurred image quality configurable
NEW enhanced cache management
NEW enhanced security
NEW tags on photos
nanoPhotosProvider2 v0.9.1 [May 12, 2017]
NEW PHP data provider for self hosted images
NEW generates responsive thumbnails automatically
NEW compatible with all layouts: grid, justified and cascading
NEW extraction of dominant colors (single color and gradient)
nanogallery2 v1.3.0 [May 11, 2017]
NEW Auto hide tools on image view after inactivity
NEW Support of nanoPhotosProvider2
NEW Display blurred image (dominant colors) during thumbnail image load
NEW New thumbnail display transitions
NEW Callback in HTML markup mode
nanogallery2 v1.2.1 [Mar 23, 2017]
FIXED misc bug fixes
nanogallery2 v1.2.0 [Mar 20, 2017]
NEW new thumbnails hover effects
NEW stack motions effects on thumbnails
nanogallery2 v1.1.0 [Mar 6, 2017]
NEW custom tools and buttons on thumbnails
NEW new callbacks and API events
nanogallery2 v1.0.0 [Feb 27, 2017]
NEW new settings
NEW new API options
NEW new callbacks and API events
nanogp v1.1.0 [Feb 20, 2017]
NEW Google Photos data provider
nanogallery2 v0.9.3 [Feb 18, 2017]
NEW improved image zoom
FIXED misc bug fixes
nanogallery2 v0.9.2a [Jan 31, 2017]
NEW support Android stock browser
FIXED misc bug fixes