react-infinite-scroll-component, react-infinite-scroller, and react-window-infinite-loader are all React packages designed to implement infinite scrolling functionality, but they take fundamentally different approaches. react-infinite-scroll-component provides a simple wrapper component that loads more content when users scroll near the bottom. react-infinite-scroller offers similar functionality with a focus on flexibility and custom scroll containers. react-window-infinite-loader takes a different approach by integrating with react-window for virtualized lists, rendering only visible items to handle large datasets efficiently. Each serves different use cases depending on your performance needs and data volume.
Infinite scrolling is a common pattern in modern web applications, letting users load more content as they scroll without pagination. But not all infinite scroll implementations are created equal. The three packages we're comparing — react-infinite-scroll-component, react-infinite-scroller, and react-window-infinite-loader — solve this problem in fundamentally different ways. Let's break down how they work and when to use each.
react-infinite-scroll-component keeps all loaded items in the DOM.
import InfiniteScroll from 'react-infinite-scroll-component';
function Feed() {
const [items, setItems] = useState(initialItems);
const fetchMoreData = () => {
// Load more items and append to existing list
setTimeout(() => {
setItems([...items, ...moreItems]);
}, 1000);
};
return (
<InfiniteScroll
dataLength={items.length}
next={fetchMoreData}
hasMore={true}
loader={<h4>Loading...</h4>}
>
{items.map(item => (
<div key={item.id}>{item.content}</div>
))}
</InfiniteScroll>
);
}
react-infinite-scroller also keeps all items in the DOM.
react-infinite-scroll-component.import InfiniteScroll from 'react-infinite-scroller';
function Feed() {
const [items, setItems] = useState(initialItems);
const fetchMoreData = () => {
setTimeout(() => {
setItems([...items, ...moreItems]);
}, 1000);
};
return (
<InfiniteScroll
pageStart={0}
loadMore={fetchMoreData}
hasMore={true}
loader={<div key={0}>Loading...</div>}
>
{items.map(item => (
<div key={item.id}>{item.content}</div>
))}
</InfiniteScroll>
);
}
react-window-infinite-loader uses virtualization.
import InfiniteLoader from 'react-window-infinite-loader';
import { FixedSizeList } from 'react-window';
function Feed({ items, loadMoreItems }) {
const isItemLoaded = index => index < items.length;
return (
<InfiniteLoader
isItemLoaded={isItemLoaded}
itemCount={items.length + 1000}
loadMoreItems={loadMoreItems}
>
{({ onItemsRendered, ref }) => (
<FixedSizeList
height={600}
itemCount={items.length}
itemSize={50}
onItemsRendered={onItemsRendered}
ref={ref}
>
{({ index, style }) => (
<div style={style} key={items[index]?.id}>
{items[index]?.content}
</div>
)}
</FixedSizeList>
)}
</InfiniteLoader>
);
}
react-infinite-scroll-component defaults to window scrolling.
scrollableTarget prop.<InfiniteScroll
dataLength={items.length}
next={fetchMoreData}
hasMore={true}
scrollableTarget="scrollableDiv"
loader={<h4>Loading...</h4>}
>
<div id="scrollableDiv" style={{ height: '400px', overflow: 'auto' }}>
{items.map(item => (
<div key={item.id}>{item.content}</div>
))}
</div>
</InfiniteScroll>
react-infinite-scroller gives explicit control over scroll target.
useWindow prop to toggle between window and element scrolling.<InfiniteScroll
pageStart={0}
loadMore={fetchMoreData}
hasMore={true}
useWindow={false}
loader={<div key={0}>Loading...</div>}
>
<div style={{ height: '400px', overflow: 'auto' }}>
{items.map(item => (
<div key={item.id}>{item.content}</div>
))}
</div>
</InfiniteScroll>
react-window-infinite-loader always uses a custom container.
react-window list component (FixedSizeList, VariableSizeList, etc.).<InfiniteLoader
isItemLoaded={isItemLoaded}
itemCount={itemCount}
loadMoreItems={loadMoreItems}
>
{({ onItemsRendered, ref }) => (
<FixedSizeList
height={600}
width={400}
itemCount={itemCount}
itemSize={50}
onItemsRendered={onItemsRendered}
ref={ref}
>
{Row}
</FixedSizeList>
)}
</InfiniteLoader>
react-infinite-scroll-component works fine for small to medium lists.
// All items stay in DOM - memory grows with each load
{items.map(item => (
<div key={item.id}>{item.content}</div>
))}
react-infinite-scroller has identical performance characteristics.
react-infinite-scroll-component.// Same issue - all rendered items persist
{items.map(item => (
<div key={item.id}>{item.content}</div>
))}
react-window-infinite-loader maintains consistent performance.
// Only visible items rendered - constant memory footprint
{({ index, style }) => (
<div style={style} key={items[index]?.id}>
{items[index]?.content}
</div>
)}
react-infinite-scroll-component uses a simple loader prop.
hasMore is true and loading.const [loading, setLoading] = useState(false);
const fetchMoreData = async () => {
if (loading) return;
setLoading(true);
const newItems = await api.fetchMore();
setItems([...items, ...newItems]);
setLoading(false);
};
<InfiniteScroll
dataLength={items.length}
next={fetchMoreData}
hasMore={hasMore}
loader={loading ? <h4>Loading...</h4> : null}
/>
react-infinite-scroller similar loader pattern.
const [loading, setLoading] = useState(false);
const fetchMoreData = async () => {
if (loading) return;
setLoading(true);
const newItems = await api.fetchMore();
setItems([...items, ...newItems]);
setLoading(false);
};
<InfiniteScroll
pageStart={0}
loadMore={fetchMoreData}
hasMore={hasMore}
loader={loading ? <div key={0}>Loading...</div> : null}
/>
react-window-infinite-loader has built-in loading state.
isItemLoaded.const isItemLoaded = index => index < items.length;
const loadMoreItems = async (startIndex, stopIndex) => {
const newItems = await api.fetchRange(startIndex, stopIndex);
setItems(prev => [...prev, ...newItems]);
};
<InfiniteLoader
isItemLoaded={isItemLoaded}
itemCount={items.length + 1000}
loadMoreItems={loadMoreItems}
>
{({ onItemsRendered, ref }) => (
<FixedSizeList
height={600}
itemCount={items.length}
itemSize={50}
onItemsRendered={onItemsRendered}
ref={ref}
>
{Row}
</FixedSizeList>
)}
</InfiniteLoader>
react-infinite-scroll-component stands alone.
// No additional dependencies needed
import InfiniteScroll from 'react-infinite-scroll-component';
react-infinite-scroller also standalone.
// Also no additional dependencies
import InfiniteScroll from 'react-infinite-scroller';
react-window-infinite-loader requires react-window.
react-window and react-window-infinite-loader.// Requires react-window as peer dependency
import InfiniteLoader from 'react-window-infinite-loader';
import { FixedSizeList, VariableSizeList } from 'react-window';
react-infinite-scroll-component is actively maintained.
react-infinite-scroller has limited recent activity.
react-window-infinite-loader is well-maintained.
react-window ecosystem by Brian Vaughn.react-window releases.| Feature | react-infinite-scroll-component | react-infinite-scroller | react-window-infinite-loader |
|---|---|---|---|
| Rendering | All items in DOM | All items in DOM | Virtualized (visible only) |
| Performance | Degrades after ~2K items | Degrades after ~2K items | Consistent at any scale |
| Scroll Target | Window or custom element | Window or custom element | Custom element only |
| Dependencies | None | None | Requires react-window |
| Setup Complexity | Low | Low | Medium |
| Memory Usage | Grows with items | Grows with items | Constant |
| Best For | Feeds, comments, search | Modals, sidebars, nested | Large datasets, dashboards |
react-infinite-scroll-component is your go-to for simple infinite scroll needs. Use it for content feeds, comment sections, or search results where you expect users to load a few hundred items at most. It's easy to set up and works well for most common use cases.
react-infinite-scroller offers similar functionality with slightly more flexibility for custom scroll containers. However, given its limited recent maintenance, consider react-infinite-scroll-component instead for new projects unless you have specific requirements it addresses better.
react-window-infinite-loader is the performance champion. If you're building admin dashboards, analytics views, or any application where users might scroll through thousands of items, this is the only serious choice. The virtualization approach keeps your app responsive regardless of data volume.
Final Thought: The right choice depends on your data scale. For under 2,000 items, keep it simple with react-infinite-scroll-component. For anything larger, invest in virtualization with react-window-infinite-loader — your users' scrolling experience will thank you.
Choose react-infinite-scroll-component if you need a straightforward infinite scroll implementation for moderate-sized lists where all items remain in the DOM. It works well for content feeds, comment sections, or search results under a few thousand items. This package is ideal when you prioritize simplicity over memory efficiency and don't need virtualization.
Choose react-infinite-scroller if you need more control over the scroll container or want to implement infinite scroll within a custom parent element. It supports both window and element scrolling, making it suitable for modals, sidebars, or nested scrollable areas. Pick this when you need flexibility in scroll target configuration.
Choose react-window-infinite-loader if you're dealing with large datasets (thousands or millions of items) where performance and memory usage are critical. It integrates with react-window to virtualize the list, rendering only visible items. This is essential for data-heavy applications like admin dashboards, analytics views, or any scenario where DOM performance matters.
A component to make all your infinite scrolling woes go away with just 4.15 kB! Pull Down to Refresh feature
added. An infinite-scroll that actually works and super-simple to integrate!
npm install --save react-infinite-scroll-component
or
yarn add react-infinite-scroll-component
// in code ES6
import InfiniteScroll from 'react-infinite-scroll-component';
// or commonjs
var InfiniteScroll = require('react-infinite-scroll-component');
<InfiniteScroll
dataLength={items.length} //This is important field to render the next data
next={fetchData}
hasMore={true}
loader={<h4>Loading...</h4>}
endMessage={
<p style={{ textAlign: 'center' }}>
<b>Yay! You have seen it all</b>
</p>
}
// below props only if you need pull down functionality
refreshFunction={refresh}
pullDownToRefresh
pullDownToRefreshThreshold={50}
pullDownToRefreshContent={
<h3 style={{ textAlign: 'center' }}>↓ Pull down to refresh</h3>
}
releaseToRefreshContent={
<h3 style={{ textAlign: 'center' }}>↑ Release to refresh</h3>
}
>
{items}
</InfiniteScroll>
<div
id="scrollableDiv"
style={{
height: 300,
overflow: 'auto',
display: 'flex',
flexDirection: 'column-reverse',
}}
>
{/*Put the scroll bar always on the bottom*/}
<InfiniteScroll
dataLength={items.length}
next={fetchMoreData}
style={{ display: 'flex', flexDirection: 'column-reverse' }} //To put endMessage and loader to the top.
inverse={true}
hasMore={true}
loader={<h4>Loading...</h4>}
scrollableTarget="scrollableDiv"
>
{items.map((_, index) => (
<div style={style} key={index}>
div - #{index}
</div>
))}
</InfiniteScroll>
</div>
The InfiniteScroll component can be used in three ways.
height prop if you want your scrollable content to have a specific height, providing scrollbars for scrolling your content and fetching more data.scrollableTarget prop to reference the DOM element and use it's scrollbars for fetching more data.height or scrollableTarget props, the scroll will happen at document.body like Facebook's timeline scroll.next() is now triggered by an IntersectionObserver watching an invisible sentinel element at the bottom of the list (top for inverse mode), rather than a scroll event listener. This means:
throttle-debounce has been removed. The package now ships with zero runtime dependencies. The onScroll callback receives every scroll event directly without throttling.
scrollableTarget accepts HTMLElement directlyPreviously scrollableTarget only accepted a string element ID. It now accepts HTMLElement | string | null, so you can pass a ref value directly:
const ref = useRef(null);
// ...
<div ref={ref} style={{ height: 300, overflow: 'auto' }}>
<InfiniteScroll scrollableTarget={ref.current} ...>
{items}
</InfiniteScroll>
</div>
The component is now a React function component. The public prop API is unchanged — no migration needed.
scrollableTarget (a parent element which is scrollable)
| name | type | description |
|---|---|---|
| next | function | a function which must be called after reaching the bottom. It must trigger some sort of action which fetches the next data. The data is passed as children to the InfiniteScroll component and the data should contain previous items too. e.g. Initial data = [1, 2, 3] and then next load of data should be [1, 2, 3, 4, 5, 6]. |
| hasMore | boolean | it tells the InfiniteScroll component on whether to call next function on reaching the bottom and shows an endMessage to the user |
| children | node (list) | the data items which you need to scroll. |
| dataLength | number | set the length of the data.This will unlock the subsequent calls to next. |
| loader | node | you can send a loader component to show while the component waits for the next load of data. e.g. <h3>Loading...</h3> or any fancy loader element |
| scrollThreshold | number | string | A threshold value defining when InfiniteScroll will call next. Default value is 0.8. It means the next will be called when user comes below 80% of the total height. If you pass threshold in pixels (scrollThreshold="200px"), next will be called once you scroll at least (100% - scrollThreshold) pixels down. |
| onScroll | function | a function that will listen to the scroll event on the scrolling container. |
| endMessage | node | this message is shown to the user when he has seen all the records which means he's at the bottom and hasMore is false |
| className | string | add any custom class you want |
| style | object | any style which you want to override |
| height | number | optional, give only if you want to have a fixed height scrolling content |
| scrollableTarget | node or string | optional, reference to a (parent) DOM element that is already providing overflow scrollbars to the InfiniteScroll component. You should provide the id of the DOM node preferably. |
| hasChildren | bool | children is by default assumed to be of type array and it's length is used to determine if loader needs to be shown or not, if your children is not an array, specify this prop to tell if your items are 0 or more. |
| pullDownToRefresh | bool | to enable Pull Down to Refresh feature |
| pullDownToRefreshContent | node | any JSX that you want to show the user, default={<h3>Pull down to refresh</h3>} |
| releaseToRefreshContent | node | any JSX that you want to show the user, default={<h3>Release to refresh</h3>} |
| pullDownToRefreshThreshold | number | minimum distance the user needs to pull down to trigger the refresh, default=100px , a lower value may be needed to trigger the refresh depending your users browser. |
| refreshFunction | function | this function will be called, it should return the fresh data that you want to show the user |
| initialScrollY | number | set a scroll y position for the component to render with. |
| inverse | bool | set infinite scroll on top |
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind are welcome!