[Bug]: Keyboard area is greyed out even when keyboard is not open.

[irshadshalu]

Bug Report

Plugin(s)

• @capacitor/keyboard

Capacitor Version

Latest Dependencies:

  @capacitor/cli: 7.4.3
  @capacitor/core: 7.4.3
  @capacitor/android: 7.4.3
  @capacitor/ios: 7.4.3

Installed Dependencies:

  @capacitor/cli: 7.0.1
  @capacitor/core: 7.0.1
  @capacitor/android: 7.0.1
  @capacitor/ios: 7.0.1

[success] iOS looking great! 👌
[success] Android looking great! 👌

Platform(s)

• Android
• iOS

Current Behavior

1. Install capacitor keyboard plugin
2. Set configuration in capacitor.config.ts

    "Keyboard": {
      "resize": "Body",
      "resizeOnFullScreen": true
    }

When opening the app from a launcher while the keyboard is already open, the area for keyboard is reserved and shows up as greyed.

Screen recording:

Screen_Recording_20250823_131427_Niagara.Launcher.mp4

Screenshot:

Expected Behavior

It should not grey out the area when the keyboard is not open.

Code Reproduction

Repo: https://github.com/irshadshalu/capacitor-keyboard-bug-sample

Other Technical Details

The entire viewport of the page is reduced in Android, which is why a grey area appears. I confirmed it with inspect element as well.

However, in iOS - this happens when going back from a page with keyboard open, entire viewport stays same, but capacitor thinks keyboard is open: (probably because of how keyboard is handled differently in both platforms.

Additional Context

I checked in existing issues and reported bugs, couldn't find the same reported. if it's a known issue, please link to that.

Keywords: keyboard, grey area, keyboard startup issue

[SenaraW]

We have a very similar keyboard resizing issue on iOS versions 17 on capacitor 6 and 7.
It worked on iOS version 15.5.

[bcampru]

Hello, we have this same error on capacitor 8 and android 16, this is impacting our production app, is there any known workarround?

[hiebj]

Fix submitted in #60.

[OS-pedrogustavobilro]

I'm not getting this error anymore with the provided app on Android 16/17 with the latest versions of Capacitor and Keyboard Plugin (without the fix in #60). Can you verify if this is still an issue for your apps for Android?

[OS-pedrogustavobilro]

I still merged the PR #60 as it makes sense to have (at the very least to fix #51).

Available in @capacitor/keyboard@8.0.4. Do let us know if this version works for you or if you still have issues.

Thank you!