---
title: "captionBarPadding"
description: "Adds padding to accommodate the [caption bar][WindowInsets.Companion.captionBar] insets.

Any insets consumed by other insets padding modifiers or [consumeWindowInsets] on a parent layout
will be excluded from the padding. [WindowInsets.Companion.captionBar] will be
[consumed][consumeWindowInsets] for child layouts as well.

For example, if a parent layout uses [displayCutoutPadding], the area that the parent layout pads
for the status bars will not be padded again by this [captionBarPadding] modifier.

When used, the [WindowInsets] will be consumed."
type: "modifier"
---

<div class='type'>Compose Modifier</div>

<a id='references'></a>
<div class='sourceset sourceset-common'>Common</div>


```kotlin
expect fun Modifier.captionBarPadding(): Modifier
```


Adds padding to accommodate the `caption bar` insets.

Any insets consumed by other insets padding modifiers or `consumeWindowInsets` on a parent layout
will be excluded from the padding. `WindowInsets.Companion.captionBar` will be
`consumed` for child layouts as well.

For example, if a parent layout uses `displayCutoutPadding`, the area that the parent layout pads
for the status bars will not be padded again by this `captionBarPadding` modifier.

When used, the `WindowInsets` will be consumed.



<div class='sourceset sourceset-android'>Android</div>


```kotlin
actual fun Modifier.captionBarPadding() =
    windowInsetsPadding(debugInspectorInfo { name = "captionBarPadding" }, captionBarLambda)
```


Adds padding to accommodate the `caption bar` insets.

Any insets consumed by other insets padding modifiers or `consumeWindowInsets` on a parent layout
will be excluded from the padding. `WindowInsets.Companion.captionBar` will be
`consumed` for child layouts as well.

For example, if a parent layout uses `displayCutoutPadding`, the area that the parent layout pads
for the status bars will not be padded again by this `captionBarPadding` modifier.

When used, the `WindowInsets` will be consumed.



## Code Examples
### captionBarPaddingSample
```kotlin
fun captionBarPaddingSample() {
    class SampleActivity : ComponentActivity() {
        override fun onCreate(savedInstanceState: Bundle?) {
            WindowCompat.setDecorFitsSystemWindows(window, false)
            super.onCreate(savedInstanceState)
            setContent {
                Box(Modifier.captionBarPadding()) {
                    // app content
                }
            }
        }
    }
}
```