Create a finite scrollable list

Scrollable lists can help manage datasets, create responsive designs, and facilitate navigation. You can display smaller collections of items in your app by using a finite scrolling list. To avoid performance issues with larger datasets or a list of unknown length, see Lazily load data with lists and Paging.

Version compatibility

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

Dependencies

Create a vertical scrolling list

Use the following code to create a vertical scrolling list:

@Composable
private fun ScrollBoxes() {
    Column(
        modifier = Modifier
            .background(Color.LightGray)
            .size(100.dp)
            .verticalScroll(rememberScrollState())
    ) {
        repeat(10) {
            Text("Item $it", modifier = Modifier.padding(2.dp))
        }
    }
}

Key points about the code

Results

A vertical list responding to scroll
gestures
Figure 1. 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.
Learn how composable functions can enable you to easily create beautiful UI components based on the Material Design design system.
This series of videos introduces various Compose APIs, quickly showing you what’s available and how to use them.

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.