Release Notes

Basic version

3.8.0 | 2026-08-31

• Custom sources are removed from the DOM instantly.
• A style "display: block !important" is added to custom sources in the lightbox.
• Removed the "data-video-poster" attribute. Add posters through the "data-poster" custom attribute instead.

3.7.6 | 2026-08-21

• Double-clicking the close button doesn't throw an error.

3.7.5 | 2026-02-14

• Added a "useDialog" prop.

3.7.4 | 2025-08-02

• A lightbox's instance is now passed as an argument to calls of events' handlers.

3.7.3 | 2025-07-27

• Added a "disableSlideSwiping" prop.

3.7.2 | 2025-07-27

• Added a "disableBackgroundClose" prop.

3.7.1 | 2025-07-26

• Fixed setting maximum YouTube videos' dimensions through the "width" and "height" custom attributes.
• Obsoleted the "maxYoutubeDimensions" prop.

3.7.0 | 2025-07-26

• Added an "onSourceLoad" event.

3.6.2 | 2025-07-11

• Decreased a little UI's size on full HD screens.

3.6.1 | 2025-05-31

• Removed an HTML error related to SVGs.

3.6.0 | 2025-05-14

• The UI's size is increased on larger screens.
• The lightbox's container is focused on open.
• The fullscreen button is hidden if fullscreen isn't supported by the user agent.
• Fullscreen is exited on lightbox close by default.

3.5.1 | 2025-02-20

• YouTube videos aren't muted if autoplay is disabled.

3.5.0 | 2025-02-15

• Autoplay.
• Videos are automatically paused on a slide change.

3.4.2 | 2024-09-17

• Added a "sourceMargin" prop.

3.4.1 | 2023-02-09

• Improved the way the dimensions of custom sources are detected.

3.4.0 | 2023-02-01

• The performance of large galleries was improved.

3.3.3 | 2023-01-25

• The lightbox no longer crashes when the local storage is completely disabled.

3.3.2 | 2023-01-09

• The shortened form of a YouTube URL is now recognized ("youtu.be").
• Parameters from a YouTube URL are no longer trimmed.
• The "enablejsapi=1" parameter is no longer added to the YouTube <iframe>.

3.3.1 | 2021-11-28

• Custom source element is no longer removed from the document after being loaded by lightbox.

3.3.0 | 2021-06-23

• Lightbox is now agnostic to hardware pointer type.
• disableLocalStorage disables now all local storage operations.
• Fixed issue with background scrolling during swiping on mobile Safari.
• Set enablejsapi parameter to 1 for YouTube sources.

3.2.3 | 2020-12-23

• Fixed issue with image disappearing when using srcset.
• Improved performance of automatic type detection.

3.2.2 | 2020-10-18

• Invalid type is no longer saved in local storage.
• Fixed issue with lightbox crashing when fslightbox <a> tag contained class attribute.

3.2.1 | 2020-08-15

• No longer need to call setup method when creating lightbox programmatically, removed setup method from FsLightbox class.

3.2.0 | 2020-08-14

• Custom sources attributes - add attributes with data- prefix to the <a> tags and attach anything you want to the sources.
• Fixed fullscreen button issue on mobile - you had to tap two times to exit fullscreen.
• By default lightbox does not exit fullscreen on close.
• Added exitFullscreenOnClose boolean prop. Set it to true and lightbox will exit fullscreen on close.
• Fixed issue with youtube video in fullscreen being covered by lightbox.
• Removed will-change css property from lightbox.

3.1.0 | 2020-01-22

• Added option to load only current slide on lightbox open.
• Fixed issue with freezing lightbox on double right click.
• Slide number is now not going beyond page when numbers are too large.

3.0.9 | 2019-12-07

• Removed request with Roboto font and changed font to Helvetica.
• Removed .hidden CSS class.

3.0.8 | 2019-11-10

• Fixed issue with not loading all source after reopening lightbox.

3.0.7 | 2019-11-05

• Fixed issue - refreshFsLightbox is not defined.

3.0.6 | 2019-11-02

• Updated way of managing YouTube videos dimensions.

3.0.5 | 2019-10-30

• Lazy loading of sources - at start lightbox loads only 3 stage sources (previous, current and next). Next ones are loaded while navigating through lightbox.

3.0.4 | 2019-10-16

• Fixed issue with wiping out lightbox with only one slide.

3.0.3 | 2019-10-13

• Renamed global function updateFsLightbox() to refreshFsLightbox().

3.0.2 | 2019-10-12

• Fixed issue with detecting scrollbar width.

3.0.1 | 2019-10-12

• Fixed issue with loading styles.

3.0.0 | 2019-10-12

• Added refreshFsLightbox() global function that detects dynamically added lightboxes or updates existing ones.
• Simplified adding Fullscreen Lightbox to webisite, now it's only js file.
• Custom sources, displaying anything you want, e.g. Google Maps, Iframes.
• Changed way of adding Vimeo videos, now you can do it via custom sources.
• Resolve CORS issues with automatic type detection via manually setting type (data-type attribute).
• Changed way of listening for events.

2.0.1 | 2019-05-24

• Adjusted cursor changing to closing lightbox when clicking in overlay

2.0.0 | 2019-05-18

• Closing lightbox when clicking in overlay
• Changing fullscreen svg on toggling fullscreen
• Controlling lightbox via keyboard (arrow keys and ESC key)
• Changed slide buttons svg
• Turned off slide swiping when there is only one slide
• Fixed issues with IE

1.7.0 | 2019-04-16

• Fixed bugs which caused library crush in IE11
• Fixed mouse event listeners issues

1.6.3 | 2019-03-29

• Fixing bugs when there were only two slides

1.6.2 | 2019-03-20

• Changed font from Montserrat to Roboto

1.6.1 | 2019-02-13

• Fixing bugs

1.6.0 | 2019-01-20

• New fade-in animation
• Improved scrollbar fix

1.5.2 | 2019-01-12

• Fixed small error which cause wiping out library in IE

1.5.1 | 2019-01-06

• Improved fade-in animation
• Fixed responsiveness bug

1.5.0 | 2018-12-29

• Added videos posters
• Renamed tag that is used to create instance

Pro version

3.8.9 | 2026-08-24

• After a lightbox's close during zooming, sources don't translate after reopening.
• Zooming is properly ended on a lightbox's close.
• The slideshow doesn't trigger after pressing a spacebar when there is only one source.

3.8.8 | 2026-08-04

• Added a "disableZoom" prop.
• Fixed the "+" and "-" keys' presses.

3.8.7 | 2026-02-25

• Increased the swipe detection's threshold to six pixels.

3.8.6 | 2026-02-19

• Added a "maxScale" prop.
• Captions are properly transformed with the "showThumbsWithCaptions" and "showThumbsOnMount" props both on.

3.8.5 | 2026-02-14

• Added a "useDialog" prop.

3.8.4 | 2025-11-04

• Added an "onSourceLoad" event.

3.8.3 | 2025-09-07

• Element nodes can be provided to the "captions" array.

3.8.2 | 2025-09-06

• Custom sources are now instantly removed from the DOM on a page's load and theirs CSS "display" properties are overriden in the lightbox.
• Added a "thumbsIcon" prop.

3.8.1 | 2025-07-11

• Decreased a little UI's size on full HD screens.

3.8.0 | 2025-05-14

• The UI's size is increased on larger screens.
• The lightbox's container is focused on open.
• The fullscreen button is hidden if fullscreen isn't supported by the user agent.
• Fullscreen is exited on lightbox close by default.

3.7.1 | 2025-02-20

• YouTube videos aren't muted if the autoplay is disabled.
• Defaulted the cursor over HTML videos.

3.7.0 | 2025-02-14

• Autoplay.
• Videos are automatically paused on a slide change.

3.6.3 | 2024-11-17

• Fixed the "data-class" custom attribute.

3.6.2 | 2024-09-17

• Added top padding to thumbs at mobile screens.

3.6.1 | 2024-08-30

• Added a "sourceMargin" prop.

3.6.0 | 2023-05-06

• Added a "showThumbsWithCaptions" prop.
• Captions are now showed on a UI's fade-out.
• Fixed an issue with the initial zoom swiping not working.

3.5.2 | 2023-04-28

• Added a "disableBackgroundClose" prop.

3.5.1 | 2023-04-11

• Fixed an error with the click zooming not working.

3.5.0 | 2023-04-09

• Added a new "disableSlideshowLoop" prop.
• Improved the way an enhanced (through a caption or thumbs) source is transformed.
• Fixed an error with the "exitFullscreenOnClose" prop not working.

3.4.9 | 2023-04-04

• Fixed an error with the UI's fade-out sometimes triggering too fast.
• Captions are no longer hidden at a UI's fade-out.

3.4.8 | 2023-02-17

• The UI fade-out may be now disabled by setting the "UIFadeOutTime" prop to "false".

3.4.7 | 2023-02-17

• The DOM element determining the scrollbar's width is now properly removed after the width is retrieved.

3.4.6 | 2023-01-26

• Improved the way the dimensions of custom sources are detected.

3.4.5 | 2023-01-24

• The lightbox no longer crashes when the local storage is completely disabled.

3.4.4 | 2023-01-10

• The shortened form of a YouTube URL is now recognized ("youtu.be").
• Parameters from a YouTube URL are no longer trimmed.
• The "enablejsapi=1" parameter is no longer added to the YouTube <iframe>.

3.4.3 | 2023-01-07

• A single thumb icon can now be provided to many sources.

3.4.2 | 2022-12-31

• Captions have been made selectable.

3.4.1 | 2021-12-15

• Fixed issue with sources display after reopening lightbox.

3.4.0 | 2021-12-14

• Improved performance of large galleries. On 400 images gallery FPS during 'normal' usage of lightbox (swiping, zooming, slide changing) increased from approximately 30FPS to 57FPS. Tested with Firefox Performance Profiler on 4 x 2.4 GHz processor.

3.3.7 | 2021-11-28

• Custom source element is no longer removed from the document after being loaded by lightbox.

3.3.6 | 2021-06-07

• Set enablejsapi parameter to 1 for YouTube sources.

3.3.5 | 2021-05-30

• Fixed issue with thumbs occasionally rendering in wrong order after their fast toggle.

3.3.4 | 2021-05-02

• Fixed issue with pointer events not working after lightbox restart.

3.3.3 | 2021-04-16

• disableLocalStorage disables now all local storage operations.
• Fixed issue with slideshow different time on different than 60 refresh rate screens.

3.3.2 | 2021-04-09

• Lightbox is now agnostic to hardware pointer type.

3.3.1 | 2020-12-22

• Fixed issue with image disappearing when using srcset.
• Fixed fullscreen button svg editing not working.
• Improved performance of automatic type detection.

3.3.0 | 2020-10-18

• Zooming on scroll.
• Customizable zoom increment.
• Custom toolbar button onClick is now invoked with fslightbox instance as param.
• Invalid type is no longer saved in local storage.
• Fixed bug with caption not hiding after changing slide during zooming.

3.2.1 | 2020-08-15

• No longer need to call setup method when creating lightbox programmatically, removed setup method from FsLightbox class.

3.2.0 | 2020-08-14

• Custom sources attributes - add attributes with data- prefix to the <a> tags and attach anything you want to the sources.
• Fixed fullscreen button issue on mobile - you had to tap two times to exit fullscreen.
• By default lightbox does not exit fullscreen on close.
• Added exitFullscreenOnClose boolean prop. Set it to true and lightbox will exit fullscreen on close.
• Fixed issue with youtube video being covered by lightbox in fullscreen in Safari browser.
• Removed will-change css property from lightbox.

3.1.0 | 2020-05-14

• 'Pinching' - zooming on mobile with 2 fingers
• Fixed error with randomly placed thumbs while showThumbsOnMount is enabled.

3.0.8 | 2020-01-22

• Added option to load only current slide on lightbox open.
• Fixed issue with freezing thumbnails after too fast swipe.
• Fixed issue with freezing lightbox on double right click.
• Slide number is now not going beyond page when numbers are too large.

3.0.7 | 2019-12-13

• Fixed issue with jumping sources when zooming via click on mobile.

3.0.6 | 2019-12-07

• Removed request with Roboto font and changed font to Helvetica.
• Removed .hidden CSS class.

3.0.5 | 2019-11-24

• Fixed issue with zooming in lightbox with only one source.

3.0.4 | 2019-11-09

• Zooming sources on clicking them.

3.0.3 | 2019-11-05

• Fixed issue with invalid thumbs indexing that caused wiping out lightbox.

3.0.2 | 2019-10-16

• Fixed issue with wiping out lightbox with only one slide.

3.0.1 | 2019-10-14

• UI is now fading out after few seconds.

3.0.0 | 2019-10-12

• Added refreshFsLightbox() global function that detect new lightboxes or updates existing ones.
• Simplified adding Fullscreen Lightbox to webisite, now it's only js file.
• Custom sources, displaying anything you want, e.g. Google Maps, Iframes.
• Changed way of adding Vimeo videos, now you can do it via custom sources.
• Resolve CORS issues with automatic type detection via manually setting type (data-type attribute).
• Changed way of listening for events.

2.1.1 | 2019-08-31

• Controlling autoplay of HTML videos, YouTube videos, Vimeo videos by adding data-autoplay attribute.

2.1.0 | 2019-08-31

• Added Vimeo support

2.0.1 | 2019-06-23

• Fixed issue with displaying video type
• Added new optional attribute data-thumbnail with which thumbnails url's can be declared manually.

2.0.0 | 2019-05-24

• Closing lightbox when clicking in overlay
• Changing fullscreen svg on toggling fullscreen
• Controlling lightbox via keyboard (arrow keys and ESC key)
• Changed slide buttons svg's
• Turned off slide swiping when there is only one slide

1.4.5 | 2019-05-13

• Fixed issue with displaying of toolbar buttons

1.4.4 | 2019-05-13

• Fixed issue with toggling slideshow
• Added startWidth, startHeight, startViewBox, pauseWidth, pauseHeight, pauseViewBox attributes to data.svg.toolbarButtons.svg object

1.4.3 | 2019-05-11

• Added elements object that contains some elements used lightbox
• Added svg object to data that contains editable properties used in lightbox svg's

1.4.2 | 2019-05-10

• Added slideButtonLeft and slideButtonRight properties to elements object that contains svg's of slide buttons
• Added slideButtonRight and slideButtonLeft properties to data object that that contains editable svg's attributes which will be used to create slide buttons

1.4.1 | 2019-04-24

• Added in data object array called a which contains all tags of instance

1.4.0 | 2019-04-17

• Fixed error with disappearing source when changing slide too fast when there are only two slides
• Fixed bug with fading-in thumbnails in IE
• Improved detecting invalid source type

1.3.2 | 2019-04-12

• Changed font from Montserrat to Roboto
• Fixed errors with with disappearing thumbnails when changing slide during zooming

1.3.1 | 2019-04-10

• Fixed disabling thumbnails

1.3.0 | 2019-03-29

• Slide show update
• Updated fade - in animation

1.2.1 | 2019-03-06

• Fixing navbar recompense

1.2.0 | 2019-03-06

• Fixing thumbnails