---
title: "BottomNavigation"
description: "Bottom navigation bars allow movement between primary destinations in an app."
type: "component"
social_image: "/static/images/material/bottom-navigation.png"
---

<div class='type'>Composable Component</div>



Bottom navigation bars allow movement between primary destinations in an app.

<img loading='lazy' class='hero-img' alt='Bottom navigation image' src='/static/images/material/bottom-navigation.png'>

<a id='references'></a>

<div class='sourceset sourceset-common'>Common</div>


```kotlin
@Composable
fun BottomNavigation(
    windowInsets: WindowInsets,
    modifier: Modifier = Modifier,
    backgroundColor: Color = MaterialTheme.colors.primarySurface,
    contentColor: Color = contentColorFor(backgroundColor),
    elevation: Dp = BottomNavigationDefaults.Elevation,
    content: @Composable RowScope.() -> Unit,
)
```


#### Parameters

| | |
| --- | --- |
| windowInsets | a window insets that bottom navigation will respect. |
| modifier | optional `Modifier` for this BottomNavigation |
| backgroundColor | The background color for this BottomNavigation |
| contentColor | The preferred content color provided by this BottomNavigation to its children. Defaults to either the matching content color for `backgroundColor`, or if `backgroundColor` is not a color from the theme, this will keep the same value set above this BottomNavigation. |
| elevation | elevation for this BottomNavigation |
| content | destinations inside this BottomNavigation, this should contain multiple `BottomNavigationItem`s |




<div class='sourceset sourceset-common'>Common</div>


```kotlin
@Composable
fun BottomNavigation(
    modifier: Modifier = Modifier,
    backgroundColor: Color = MaterialTheme.colors.primarySurface,
    contentColor: Color = contentColorFor(backgroundColor),
    elevation: Dp = BottomNavigationDefaults.Elevation,
    content: @Composable RowScope.() -> Unit,
)
```


#### Parameters

| | |
| --- | --- |
| modifier | optional `Modifier` for this BottomNavigation |
| backgroundColor | The background color for this BottomNavigation |
| contentColor | The preferred content color provided by this BottomNavigation to its children. Defaults to either the matching content color for `backgroundColor`, or if `backgroundColor` is not a color from the theme, this will keep the same value set above this BottomNavigation. |
| elevation | elevation for this BottomNavigation |
| content | destinations inside this BottomNavigation, this should contain multiple `BottomNavigationItem`s |






## Code Examples
### BottomNavigationSample
```kotlin
@Composable
fun BottomNavigationSample() {
    var selectedItem by remember { mutableStateOf(0) }
    val items = listOf("Songs", "Artists", "Playlists")
    BottomNavigation(windowInsets = BottomNavigationDefaults.windowInsets) {
        items.forEachIndexed { index, item ->
            BottomNavigationItem(
                icon = { Icon(Icons.Filled.Favorite, contentDescription = null) },
                label = { Text(item) },
                selected = selectedItem == index,
                onClick = { selectedItem = index },
            )
        }
    }
}
```