Preferences(bpy_struct)

base class — bpy_struct

class bpy.types.Preferences(bpy_struct)

Global preferences

active_section

Active section of the preferences shown in the user interface

Type

enum in [‘INTERFACE’, ‘THEMES’, ‘VIEWPORT’, ‘LIGHTS’, ‘EDITING’, ‘ANIMATION’, ‘ADDONS’, ‘INPUT’, ‘NAVIGATION’, ‘KEYMAP’, ‘SYSTEM’, ‘SAVE_LOAD’, ‘FILE_PATHS’, ‘EXPERIMENTAL’], default ‘INTERFACE’

addons
Type

Addons bpy_prop_collection of Addon, (readonly)

app_template
Type

string, default “”, (never None)

apps

Preferences that work only for apps

Type

PreferencesApps, (readonly, never None)

autoexec_paths
Type

PathCompareCollection bpy_prop_collection of PathCompare, (readonly)

edit

Settings for interacting with Blender data

Type

PreferencesEdit, (readonly, never None)

experimental

Settings for features that are still early in their development stage

Type

PreferencesExperimental, (readonly, never None)

filepaths

Default paths for external files

Type

PreferencesFilePaths, (readonly, never None)

inputs

Settings for input devices

Type

PreferencesInput, (readonly, never None)

is_dirty

Preferences have changed

Type

boolean, default False

keymap

Shortcut setup for keyboards and other input devices

Type

PreferencesKeymap, (readonly, never None)

studio_lights
Type

StudioLights bpy_prop_collection of StudioLight, (readonly)

system

Graphics driver and operating system settings

Type

PreferencesSystem, (readonly, never None)

themes
Type

bpy_prop_collection of Theme, (readonly)

ui_styles
Type

bpy_prop_collection of ThemeStyle, (readonly)

use_preferences_save

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

Type

boolean, default True

version

Version of Blender the userpref.blend was saved with

Type

int array of 3 items in [0, inf], default (0, 0, 0), (readonly)

view

Preferences related to viewing data

Type

PreferencesView, (readonly, never None)

classmethod bl_rna_get_subclass(id, default=None)
Parameters

id (string) – The RNA type identifier.

Returns

The RNA type or default when not found.

Return type

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)
Parameters

id (string) – The RNA type identifier.

Returns

The class or default when not found.

Return type

type

Inherited Properties

Inherited Functions

References