Preferences(bpy_struct)

base class — bpy_struct

class bpy.types.Preferences(bpy_struct)

Global preferences

active_section

Preferences (default 'INTERFACE')

Type:

Literal[Preference Section Items]

addons

(default None, readonly)

Type:

Addons[Addon]

app_template

(default “”, never None)

Type:

str

apps

Preferences that work only for apps (readonly, never None)

Type:

PreferencesApps

autoexec_paths

(default None, readonly)

Type:

PathCompareCollection[PathCompare]

edit

Settings for interacting with Blender data (readonly, never None)

Type:

PreferencesEdit

experimental

Settings for features that are still early in their development stage (readonly, never None)

Type:

PreferencesExperimental

extensions

Settings for extensions (readonly, never None)

Type:

PreferencesExtensions

filepaths

Default paths for external files (readonly, never None)

Type:

PreferencesFilePaths

inputs

Settings for input devices (readonly, never None)

Type:

PreferencesInput

is_dirty

Preferences have changed (default False)

Type:

bool

keymap

Shortcut setup for keyboards and other input devices (readonly, never None)

Type:

PreferencesKeymap

show_hidden_ids

Show data-blocks with dot-prefixed names in search menus (default False)

Type:

bool

studio_lights

(default None, readonly)

Type:

StudioLights[StudioLight]

system

Graphics driver and operating system settings (readonly, never None)

Type:

PreferencesSystem

themes

(default None, readonly)

Type:

bpy_prop_collection[Theme]

ui_styles

(default None, readonly)

Type:

bpy_prop_collection[ThemeStyle]

use_preferences_save

Save preferences on exit when modified (unless factory settings have been loaded) (default True)

Type:

bool

use_recent_searches

Sort the recently searched items at the top (default True)

Type:

bool

version

Version of Blender the userpref.blend was saved with (array of 3 items, in [0, inf], default (0, 0, 0), readonly)

Type:

bpy_prop_array[int]

view

Preferences related to viewing data (readonly, never None)

Type:

PreferencesView

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (bpy.types.Struct | None) – The value to return when not found.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct

classmethod bl_rna_get_subclass_py(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (type | None) – The value to return when not found.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions

References