large Flutter Favorite logosmall Flutter Favorite logo

infinite_scroll_pagination 3.2.0 icon indicating copy to clipboard operation
infinite_scroll_pagination: ^3.2.0 copied to clipboard

Lazily load and display pages of items as the user scrolls down your screen.

Package Logo with Flutter Favorite Badge

Chosen as a Flutter Favorite by the Flutter Ecosystem Committee Badge GitHub Build Badge Code Coverage Badge Gitter Badge Effective Dart Badge MIT License Badge Flutter Platform Badge

Infinite Scroll Pagination #

Unopinionated, extensible and highly customizable package to help you lazily load and display small chunks of items as the user scrolls down the screen – known as infinite scrolling pagination, endless scrolling pagination, auto-pagination, lazy loading pagination, progressive loading pagination, etc.

Designed to feel like part of the Flutter framework.

Example Project

Tutorial #

By (step-by-step, hands-on, in-depth and illustrated).

Usage #

class CharacterListView extends StatefulWidget {
  _CharacterListViewState createState() => _CharacterListViewState();

class _CharacterListViewState extends State<CharacterListView> {
  static const _pageSize = 20;

  final PagingController<int, CharacterSummary> _pagingController =
      PagingController(firstPageKey: 0);

  void initState() {
    _pagingController.addPageRequestListener((pageKey) {

  Future<void> _fetchPage(int pageKey) async {
    try {
      final newItems = await RemoteApi.getCharacterList(pageKey, _pageSize);
      final isLastPage = newItems.length < _pageSize;
      if (isLastPage) {
      } else {
        final nextPageKey = pageKey + newItems.length;
        _pagingController.appendPage(newItems, nextPageKey);
    } catch (error) {
      _pagingController.error = error;

  Widget build(BuildContext context) => 
      // Don't worry about displaying progress or error indicators on screen; the 
      // package takes care of that. If you want to customize them, use the 
      // [PagedChildBuilderDelegate] properties.
      PagedListView<int, CharacterSummary>(
        pagingController: _pagingController,
        builderDelegate: PagedChildBuilderDelegate<CharacterSummary>(
          itemBuilder: (context, item, index) => CharacterListItem(
            character: item,

  void dispose() {

For more usage examples, please take a look at our cookbook or check out the example project.

Features #

API Overview #

API Diagram

pub points


verified publisher

Lazily load and display pages of items as the user scrolls down your screen.

Repository (GitHub)


API reference


Icon for licenses.MIT (LICENSE)


flutter, sliver_tools


Packages that depend on infinite_scroll_pagination