Release Notes

Basic version

2.0.0 | 2025-08-13

• Changed the base architecture to vanilla JS.
• The UI's size on larger screens is increased.
• The lightbox's container is now focused on open.
• Added an "onSourceLoad" prop.
• The fullscreen button is hidden if fullscreen isn't supported by the user agent.
• Fullscreen is exited on lightbox's close by default.
• Components can now be put to the "sources" prop directly, without wrapping.
• Removed the "source" slide-number-controlling prop—since the allowance of putting custom sources to the "sources" prop, it's useless.
• Removed the misplaced "O" letter from the top-left corner.
• Obsoleted the "maxYoutubeVideoDimensions" prop. Set maximal dimensions via custom attributes instead.

1.8.0 | 2025-02-25

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

1.7.6 | 2023-06-17

• Fixed the swiping for Chromium-based mobile browsers.

1.7.5 | 2023-04-24

• Added a "disableBackgroundClose" prop.

1.7.4 | 2023-04-20

• The "pointerdown" event's default actions are now prevented only if the target is an image.

1.7.3 | 2023-04-14

• Added a "disableSlideSwiping" prop.

1.7.2 | 2023-02-16

• The flickering of the lightbox at its close was fixed.

1.7.1 | 2023-02-08

• The lightbox no longer crashes when the local storage is completely disabled.
• Improved the way the dimensions of custom sources are detected.

1.7.0 | 2023-02-06

• The performance of large galleries was improved.

1.6.3 | 2023-01-17

• 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>.

1.6.2 | 2021-01-03

• Fixed issue with maxYoutubeVideoDimensions prop not working.

1.6.1 | 2020-12-28

• disableLocalStorage disables now all local storage operations.
• Improved performance of automatic type detection.
• Fixed issue with lightbox not reopening on one exact slide after slide changing.
• Fixed issue with timeouts called after lightbox close crashing plugin, e.g. after changing slide and immediately closing lightbox.

1.6.0 | 2020-08-20

• Lightbox is now initialized on first open not at mount - props updates will be detected until opening lightbox.
• Removed deprecated customSources and videosPosters props.
• Invalid type is no longer saved in local storage.

1.5.0 | 2020-08-14

• New customAttributes prop - adding any attribute 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.

1.4.9 | 2020-01-20

• Added option to load only current slide on lightbox open.

1.4.8 | 2020-01-20

• Fixed issue with freezing lightbox on double right click.
• Slide number is now not going beyond page when numbers are too large.

1.4.7 | 2019-12-23

• Fixed error with remounting opened lightbox.

1.4.6 | 2019-12-07

• Removed request with Roboto font and changed font to Helvetica.

1.4.5 | 2019-11-13

• Fixed issue with reopening lightbox with one source.

1.4.4 | 2019-11-09

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

1.4.3 | 2019-10-28

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

1.4.2 | 2019-10-04

• No longer need to declare max dimensions of custom sources. Now they are detected from custom sources elements directly.

1.4.1 | 2019-09-21

• Fixed issue with closing lightbox when clicking on custom source.

1.4.0 | 2019-09-02

• Displaying custom sources like: Vimeo videos, Google maps, text fields, whatever you want.
• Lightbox now detect changing fullscreen via F11 key.

1.3.3 | 2019-07-28

• Removed dev package from dependencies

1.3.2 | 2019-07-26

• Added new prop openOnMount. If set to true lightbox will open on mount.
• Initial value of toggler prop no longer decides about opening lightbox on mount.

1.3.1 | 2019-07-15

• Added new prop type with which you can declare type of all sources at once.

1.3.0 | 2019-06-26

• Added new prop source which works same as slide prop, but instead of taking slide takes source.
• Added new prop sourceIndex which works same as slide prop, but instead of taking slide takes source index.
• Changed functionality of urls prop to sources prop, urls prop is now deprecated.

1.2.0 | 2019-06-12

• Added new prop - types- it's an array with which you can declare urls types manually. It solves problem with automatic type detection of urls without CORS enabled.

1.1.1 | 2019-06-09

• Fixed storing sources types in local storage for IE

1.1.0 | 2019-06-05

• SSR support
• Improved source type detecting - once url type is detected it will be stored in local storage. Can be disabled via props.
• Update slide buttons svg's

1.0.0 | 2019-05-18

• Introducing React Fullscreen Lightbox!

0.9.1 | 2019-05-10

• [Development] working version - basic usage available

Pro version

1.8.1 | 2025-03-13

• Sources now properly adjust to captions.

1.8.0 | 2025-03-11

• Autoplay.
• Videos are automatically paused on a slide change.
• Fixed the "loadOnlyCurrentSource" prop.
• Fixed reopening lightbox on a given slide after slide changing.
• Fixed invalid thumbs in case of state changing in events' handlers.

1.7.10 | 2025-01-23

• Removed a mistakenly rendered "0" in the top-left corner of the lightbox.

1.7.9 | 2024-12-24

• A state change in lightbox's events' handlers don't crush the lightbox.
• A YouTube video can be swiped over.

1.7.8 | 2023-08-04

• Fixed an issue with the UI not hiding on a pinching start.

1.7.7 | 2023-05-26

• Further adjustment to the "'closeLightbox' is not a function" issue.

1.7.6 | 2023-05-19

• Fixed the "'closeLightbox' is not a function" issue.

1.7.5 | 2023-05-12

• Fixed the initial zoom swipe.

1.7.4 | 2023-04-27

• Fixed the toolbar's fullscreen button.

1.7.3 | 2023-04-24

• Added a "disableBackgroundClose" prop.

1.7.2 | 2023-04-18

• The "pointerdown" event's default actions are now prevented only if the target is an image.
• The "zoom-in" cursor is now added only to an image source.

1.7.1 | 2023-04-13

• Added a new "disableSlideSwiping" prop.

1.7.0 | 2023-04-10

• Added a new "disableSlideshowLoop" prop.
• Improved the way an enhanced (through a caption or thumbs) source is transformed.

1.6.2 | 2023-03-22

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

1.6.1 | 2023-02-17

• The lightbox no longer crashes when the local storage is completely disabled.
• The way custom sources are detected was improved.

1.6.0 | 2023-02-16

• The performance of large galleries was improved.

1.5.3 | 2023-01-16

• 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>.

1.5.2 | 2023-01-04

• Captions have been made selectable.
• Fixed the issue with thumbs still clickable, even though invisible, after their hiding.

1.5.1 | 2021-05-29

• Added onZoomingStart and onZoomingEnd events.
• Fixed issue with initialAnimation not working.

1.5.0 | 2021-05-30

• Lightbox is now agnostic to hardware pointer type.
• Fixed issue with slideshow different time on different than 60 refresh rate screens.
• Fixed issue with lightbox sometimes blinking at close.

1.4.2 | 2021-01-03

• Fixed issue with maxYoutubeVideoDimensions prop not working.

1.4.1 | 2021-01-02

• disableLocalStorage disables now all local storage operations.
• Improved performance of automatic type detection.
• Fixed issue with lightbox not reopening on one exact slide after slide changing.
• Fixed issue with timeouts called after lightbox close crashing plugin, e.g. after changing slide and immediately closing lightbox.

1.4.0 | 2020-11-27

• Zooming on scroll.
• Customizable zoom increment.
• Lightbox is now initialized on first open not at mount - props updates will be detected until opening lightbox.
• 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.
• Removed deprecated customSources and videosPosters props.

1.3.0 | 2020-08-14

• New customAttributes prop - adding any attribute you want to the sources.
• Fixed fullscreen button issue on mobile - you had to tap two times to exit fullscreen.
• 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.

1.2.1 | 2020-06-22

• By default lightbox does not exit fullscreen on close.
• Added exitFullscreenOnClose boolean prop. Set it to true and lightbox will exit fullscreen on close.

1.2.0 | 2020-05-13

• 'Pinching' - zooming on mobile with 2 fingers

1.1.1 | 2020-01-20

• 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.

1.1.0 | 2019-12-22

• Fixed error with remounting opened lightbox.

1.0.9 | 2019-12-13

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

1.0.8 | 2019-12-07

• Removed request with Roboto font and changed font to Helvetica.

1.0.7 | 2019-11-24

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

1.0.6 | 2019-11-13

• Fixed issue with reopening lightbox with one source.

1.0.5 | 2019-11-10

• Zooming sources on clicking them.

1.0.4 | 2019-11-07

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

1.0.3 | 2019-10-28

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

1.0.2 | 2019-10-14

• UI is now fading out after few seconds.

1.0.1 | 2019-10-04

• No longer need to declare max dimensions of custom sources. Now they are detected from custom sources elements directly.

1.0.0 | 2019-08-30

• Introducing React Fullscreen Lightbox Pro