Display nested scrolling items in a list

You can display nested scrolling items within a list to present complex layouts, such as product catalogs, media galleries, news feeds, and more.

Version compatibility

This implementation requires that your project minSDK be set to API level 21 or higher.

Dependencies

Implement nested horizontal scrolling in vertical list

The following code produces a list that scrolls two ways. The rows of the list scroll horizontally; the list as a whole—a single column—scrolls vertically.

@Composable
fun NestedScrollingRowsList(urls: List<String>) {
    LazyColumn {
        items(10) {
            LazyRow {
                item { Text("Row: $it") }
                items(urls.size) { index ->
                    // AsyncImage provided by Coil.
                    AsyncImage(
                        model = urls[index],
                        modifier = Modifier.size(150.dp),
                        contentDescription = null
                    )
                }
            }
        }
    }
}
NestedScrollingItem.kt

Results

Nested horizontal lists within a vertical scrolling list
Figure 1. Nested horizontal lists within a vertical scrolling list.

Collections that contain this guide

This guide is part of these curated Quick Guide collections that cover broader Android development goals:

Lists and grids allow your app to display collections in a visually pleasing form that's easy for users to consume.
Quick guide collection
Learn how composable functions can enable you to easily create beautiful UI components based on the Material Design design system.
Quick guide collection
This series of videos introduces various Compose APIs, quickly showing you what’s available and how to use them.
Quick guide collection

Have questions or feedback

Go to our frequently asked questions page and learn about quick guides or reach out and let us know your thoughts.
Go to FAQ Leave feedback