How to Stop the Scroll Lock LED Toggling When Switching Keyboard Layouts on GNOME Wayland

Abstract: If your Scroll Lock LED turns on whenever you switch to a secondary keyboard layout, the culprit is the grp_led:scroll XKB option inherited into GNOME's input settings. Here is how to remove it.

Created: 2026-11-02 by

The Scroll Lock LED lighting up when you switch to a secondary keyboard layout (and going dark again when you switch back) is not a hardware fault or a broken key. It is caused by the XKB option grp_led:scroll, which deliberately repurposes the Scroll Lock indicator as a "second layout active" signal. Removing this option from GNOME's per-user settings and from the system-wide keyboard configuration fixes the behavior on Wayland, where classic X11 tools like xmodmap and setxkbmap have no effect.

Why the LED changes when you switch layouts

Historically, X11 had no dedicated visual indicator for keyboard layout, so XKB offered a family of options named grp_led:* that bind the layout group to an existing keyboard LED. The variant grp_led:scroll makes the Scroll Lock LED light up whenever any layout other than the first one is active. If your layouts are, for example, US English and German, the LED turns on the moment you switch to German and turns off when you return to English — which looks exactly like Scroll Lock engaging and disengaging on its own.

Two things often confuse people experiencing this:

  • Pressing the physical Scroll Lock key does nothing, because the LED is no longer controlled by the Scroll Lock modifier state at all — it is bound to the layout group.
  • The option usually is not something you chose yourself. It is typically set during installation or by a distribution default, and GNOME imports the system-wide XKB options into your per-user settings the first time you log in.

Diagnosis: check where the option is set

On a GNOME Wayland session, check two places. First, the user-level GNOME settings:

gsettings get org.gnome.desktop.input-sources xkb-options
localectl status

If the gsettings output contains grp_led:scroll, that is what your session is using right now. The localectl output may also show X11 Options: grp_led:scroll, which reflects the system-wide configuration stored in /etc/default/keyboard and is what the GDM login screen uses.

It is worth confirming this is the real cause before changing anything: while the LED is lit, type into a terminal or a text editor. If keypad and arrow-key behavior is also misbehaving in applications like spreadsheets (because those apps react to the Scroll Lock state), the bound LED is genuinely telling applications Scroll Lock is on.

Fix: remove the option from GNOME's settings

GNOME offers no graphical interface for XKB options beyond choosing the Compose and AltGr keys, so you need to set the value directly. An empty list disables all extra XKB options:

gsettings set org.gnome.desktop.input-sources xkb-options "[]"

Verify with gsettings get org.gnome.desktop.input-sources xkb-options — it should now report an empty array. The change takes effect immediately; switching layouts should no longer touch the LED. No logout is required, though restarting the session is a clean way to confirm nothing is re-applying the option.

Note that removing grp_led:scroll does not restore the LED's normal Scroll Lock function in GNOME Wayland. GNOME does not wire the Scroll Lock modifier into the LED by default, so the key simply stays inert unless you reassign it to something else (for instance, as a Compose key via compose:sclk in the same options list).

Fix: also clean up the system-wide configuration

The per-user fix covers your session, but GDM (the login screen) reads /etc/default/keyboard, so the LED behavior will persist on the greeter until you edit that file as well. Set XKBOPTIONS to an empty value:

XKBMODEL="pc105"
XKBLAYOUT="us,de"
XKBVARIANT=","
XKBOPTIONS=""

You generally cannot fix this with localectl on Debian/Ubuntu: the D-Bus policy explicitly forbids localectl from modifying keyboard configuration there, so editing the file directly with an editor and sudo is the reliable route.

Why xmodmap and X11-era fixes do not help

Under Xorg, remapping the Scroll Lock key or LED with xmodmap or editing files under /usr/share/X11/xkb/symbols/ could change this behavior. On a Wayland session the compositor (GNOME's Mutter) manages keyboard state itself; those tools either fail or affect only legacy XWayland clients. The grp_led binding in particular is applied by the compositor from the XKB options in org.gnome.desktop.input-sources, which is why the only effective fix is removing the option at the source.

Prevention

  • After a fresh install, review localectl status and gsettings get org.gnome.desktop.input-sources xkb-options if any LED behaves oddly after layout switches.
  • If you later want a layout indicator, prefer GNOME's built-in top-bar layout indicator rather than LED-based options.
  • When adding your own XKB options (such as a Compose key position), include only the options you actually want in the list — anything inherited from the installer, like grp_led:scroll, will ride along otherwise.

Frequently Asked Questions

Why does my Scroll Lock key not toggle anything at all?

Because the LED is currently bound to the layout group instead of the Scroll Lock modifier. Even after removing grp_led:scroll, GNOME on Wayland does not automatically restore the classic "press Scroll Lock to toggle scrolling state" behavior; the key will simply do nothing unless you assign it a function, such as making it a Compose key.

I edited the xkb symbols files and added a modifier map — why no change?

On Wayland, Mutter loads its own keyboard configuration from GNOME's settings; hand-editing /usr/share/X11/xkb/symbols/ files or adding modifier_map Mod3 lines does not reliably affect the session. Adjusting the xkb-options key in org.gnome.desktop.input-sources is the supported way.

Can I use localectl to clear the option system-wide?

Not on Debian/Ubuntu. The D-Bus policy there explicitly prohibits localectl from writing keyboard configuration, so edit /etc/default/keyboard directly with root privileges.

Does clearing xkb-options break my layout switching?

No. Layout selection and switching shortcuts are managed separately from XKB options. Clearing the list only removes extras like LED binding, Compose key placement, or custom key behavior that were explicitly listed.

The LED is fixed in my session but still wrong on the login screen. What now?

GDM reads /etc/default/keyboard, not your per-user GNOME settings. Make sure XKBOPTIONS is empty in that file, then log out or restart to see the change on the greeter.

Latest News

How to Display Output of xterm Command in Terminal Screen using Cron

Resolve the inability to display xterm output in a terminal screen from cron by redirecting logs or using wall instead of insecure X11 workarounds.

Read More
Expose Local Server on VPS Preserving Real Client IPs (OS Level)

Resolve VPS logging showing only gateway IPs by configuring reverse proxies to forward real client addresses via X-Forwarded-For headers.

Read More
How to Clear Recent Files History in Linux without Deleting Actual Files?

Clear recent files history in Linux by deleting ~/.local/share/recently-used.xbel without removing the actual files.

Read More
Best HDD Copy Strategy: Manually Syncing and Rewriting Scratch

Resolve data drift between two 4TB hard drives by using rsync with the --delete flag to manually sync and rewrite scratch data for an exact mirror.

Read More
Understanding Bash Prompt Abbreviations: An Overview

Resolve repetitive typing errors by creating and persisting Bash aliases in the .bashrc file for improved command-line efficiency.

Read More
Free Tools and Methods to Log Real-Time Performance Details in Task Manager

Log real-time CPU and memory metrics to CSV files using Windows Performance Monitor Data Collector Sets to troubleshoot system slowness.

Read More
Contact Qatar Airways Customer Service: Phone Number, Help Center, and More

Resolve urgent Qatar Airways reservation issues like flight changes and baggage claims using the US phone number +1801-855-5905 or online self-service tools.

Read More
Windows 11: Alt Codes Displaying Wrong Characters - Solutions

Resolve Windows 11 Alt codes showing wrong characters by verifying the US keyboard layout and enabling Num Lock.

Read More
Run Programs with Elevated Privileges: A Comprehensive Guide

Eliminates the need to type sudo for frequent administrative tasks by configuring .bashrc aliases or functions.

Read More
Dynamically Changing Dates in Excel Formulas Using Cells

Eliminate manual date updates in Excel by using cell references to create dynamic formulas that automatically adjust calculations when input dates change.

Read More
Granting Edit Access to a Specific Excel Sheet in an Office 365 User Email ID-Based Login

Excel Online lacks native sheet-level permissions, so users must split workbooks or use worksheet protection to isolate edit access for specific tabs.

Read More
Creating Network Load on Local Wi-Fi from One PC

Generate sustained Wi-Fi bandwidth load from a single PC using a VM SFTP server to test router stability and throughput.

Read More
Changing the Default Editor for Batch Files in Windows 11's File Explorer

Resolve the issue of batch files opening in Notepad by changing the default editor to a preferred application like VS Code.

Read More
Gain WiFi Connection Minutes Before Losing it by Changing MAC Address

Bypass MAC address filtering to restore WiFi connectivity temporarily when a device is blocked by network administrators.

Read More
Photos Folders Turned Black: Troubleshooting Picture Applications on Windows

Resolve black screens in Windows Photos by resetting the app, updating graphics drivers, and repairing system files.

Read More
Troubleshooting High CPU Temperature Values: A Step-by-Step Guide

Resolve high CPU temperatures and thermal throttling by monitoring with Speedfan, cleaning dust from cooling components, and replacing degraded thermal paste.

Read More
Make cURL establish TLS connection with CA unknown

Resolve cURL TLS connection failures with unknown or self-signed certificates by using the --insecure flag to bypass CA validation.

Read More
Troubleshooting Incorrect Network Metrics Values in Grafana, Prometheus, InfluxDB, and Telegraf

Fix incorrect network metrics in Grafana, Prometheus, InfluxDB, and Telegraf by verifying interface selection, resolving unit mismatches, and handling counter resets.

Read More
Start Another Terminal Window (cmd.exe) Windows Repair/Troubleshoot

Provides step-by-step instructions to access the Windows Command Prompt via bootable media for advanced system repair and troubleshooting.

Read More
Thinkpad P1 Gen 6: Sudden Thunderbolt 3 Dock USB-C Charging Stopped Working

Resolve sudden Thunderbolt 3 dock USB-C charging and internet failure on ThinkPad P1 Gen 6 by updating firmware, resetting the dock, and adjusting power settings.

Read More
ASUS Windows 11 Laptop: Internet Connection Issue with Hotspot

Resolve ASUS Windows 11 laptop spinning wheel issue when connecting to mobile hotspot by resetting network stack, disabling IPv6, and adjusting power settings.

Read More
Developing iOS Project with Firebase: Logging in and Sending Push Notifications

Integrates Firebase to enable secure user authentication and push notifications in iOS applications.

Read More
Troubleshooting Bash Script with Suspected Issues of Spaces, Dashes, Filenames and Quoting

Resolve Bash script failures caused by word splitting, globbing, and special characters in filenames by applying proper quoting techniques.

Read More
Populating OneDrive Folder for Local Backup without Affecting Remote Files

Prevent OneDrive from deleting remote files during Windows reinstallation by unlinking the account or using symbolic links to isolate local data.

Read More
Force First Frame as Keyframe Without Re-encoding: A Quick Solution

Resolve inaccurate seeking and playback glitches by re-encoding video to ensure the first frame is a valid keyframe.

Read More
Find Information in Database Using WSL (Ubuntu) on Windows-10

Resolve database connection issues from WSL Ubuntu on Windows 10 by configuring client tools and network access to query remote or local servers.

Read More
Configuring a New Router with Different Networks: One Family, One Guest

Resolve IP conflicts and isolate guest traffic by configuring a second router with a distinct subnet via its WAN port.

Read More
Quickly Open Multiple Stock Websites with a Single Command

Solve the problem of manually opening multiple stock research websites by creating a single command to launch them simultaneously on Windows, macOS, or Linux.

Read More
Improved Adobe Acrobat Search Experience: Access Advanced Search with Ease

Access advanced search filters like case sensitivity and regex in Adobe Acrobat by clicking More Options in the Find bar.

Read More
Port Forwarding VM via OpenVPN: A Comprehensive Guide

Configure OpenVPN server and iptables to forward specific ports from VPN clients to a virtual machine's internal IP address.

Read More
Understanding Partitions in the 1980s: A Look Back at MS-DOS and Master Boot Record

Explains how the Master Boot Record and partition table enabled MS-DOS to manage multiple disk volumes on a single physical drive.

Read More
Windows 10 Enterprise: Keyboard Not Detected in Managed Organization with Admin Privileges

Resolve Windows 10 Enterprise keyboard detection failures caused by Group Policy restrictions, driver corruption, or USB enumeration errors.

Read More
Can't Find x86_64 Versions of Applications on MacOS arm64 (M1)

Resolve missing x86_64 app issues on M1 Macs by installing Rosetta 2 and reinstalling apps as universal binaries.

Read More
How to Hide Installation Source for an Android App

Manage Android app installation source visibility by using USB transfers or file managers to reduce browser traces and isolate data via work profiles.

Read More
Connecting Momentus 4200.2 ST9808210A Hard Drive via USB Cable

Resolve inability to access Seagate Momentus 4200.2 ST9808210A hard drive by connecting it via USB using a compatible SATA-to-USB adapter and configuring the disk in Windows.

Read More