snippetbashTip

gsettings — Query and modify dconf settings with schema validation. More information: <https://access.redhat.com

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

commandgsettingsdconfandmodifycliquerysettings

linux

Problem

How to use the gsettings command: Query and modify dconf settings with schema validation. More information: <https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/using_the_desktop_environment_in_rhel_8/configuring-gnome-at-low-level_using-the-desktop-environment-in-rhel-8#using-gsettings-command_configuring-gnome-at-low-level>.

Solution

gsettings — Query and modify dconf settings with schema validation. More information: <https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/using_the_desktop_environment_in_rhel_8/configuring-gnome-at-low-level_using-the-desktop-environment-in-rhel-8#using-gsettings-command_configuring-gnome-at-low-level>.

Set the value of a key. Fails if the key doesn't exist or the value is out of range:

gsettings set {{org.example.schema}} {{example-key}} {{value}}

Print the value of a key or the schema-provided default if the key has not been set in dconf:

gsettings get {{org.example.schema}} {{example-key}}

Unset a key, so that its schema default value will be used:

gsettings reset {{org.example.schema}} {{example-key}}

Display all (non-relocatable) schemas, keys, and values:

gsettings list-recursively

Display all keys and values (default if not set) from one schema:

gsettings list-recursively {{org.example.schema}}

Display schema-allowed values for a key (helpful with enum keys):

gsettings range {{org.example.schema}} {{example-key}}

Display the human-readable description of a key:

gsettings describe {{org.example.schema}} {{example-key}}

Code Snippets

Set the value of a key. Fails if the key doesn't exist or the value is out of range

gsettings set {{org.example.schema}} {{example-key}} {{value}}

Print the value of a key or the schema-provided default if the key has not been set in `dconf`

gsettings get {{org.example.schema}} {{example-key}}

Unset a key, so that its schema default value will be used

gsettings reset {{org.example.schema}} {{example-key}}

Display all (non-relocatable) schemas, keys, and values

gsettings list-recursively

Display all keys and values (default if not set) from one schema

gsettings list-recursively {{org.example.schema}}

Context

tldr-pages: linux/gsettings

Revisions (0)

No revisions yet.