Skip to content
From v1 to v2

Migration

Version 2 intentionally modernizes names and behavior. The old API appears here only so migrations are searchable.

Prop map

transitionTime becomes duration. renderLoader becomes renderPlaceholder. disableLoader becomes placeholder={null} or placeholder="empty". wrapperClassName becomes containerClassName. isResponsive becomes width, height, aspectRatio, srcSet, and sizes. lazyLoad becomes lazy. useChild becomes asChild. element becomes as.

Recommended order

Upgrade React, install v2, import the stylesheet, replace prop names, add missing alt text, and move complex custom flows to ImageLoader or useImage.