Context Access (bpy.context)
The context members available depend on the area of Blender which is currently being accessed.
Note that all context values are readonly, but may be modified through the data API or by running operators
Global Context
These properties are available in any contexts.
- bpy.context.area
- Type:
bpy.types.Area
, (readonly)
- bpy.context.asset_file_handle
The file of an active asset. Avoid using this, it will be replaced by a proper AssetHandle design
- Type:
bpy.types.FileSelectEntry
, (readonly)
- bpy.context.blend_data
- Type:
bpy.types.BlendData
, (readonly)
- bpy.context.collection
- Type:
bpy.types.Collection
, (readonly)
- bpy.context.engine
- Type:
string, default “”, (readonly, never None)
- bpy.context.gizmo_group
- Type:
bpy.types.GizmoGroup
, (readonly)
- bpy.context.layer_collection
- Type:
bpy.types.LayerCollection
, (readonly)
- bpy.context.mode
- Type:
enum in Context Mode Items, default ‘EDIT_MESH’, (readonly)
- bpy.context.preferences
- Type:
bpy.types.Preferences
, (readonly)
- bpy.context.region
- Type:
bpy.types.Region
, (readonly)
- bpy.context.region_data
- Type:
bpy.types.RegionView3D
, (readonly)
- bpy.context.scene
- Type:
bpy.types.Scene
, (readonly)
- bpy.context.screen
- Type:
bpy.types.Screen
, (readonly)
- bpy.context.space_data
- Type:
bpy.types.Space
, (readonly)
- bpy.context.tool_settings
- Type:
bpy.types.ToolSettings
, (readonly)
- bpy.context.view_layer
- Type:
bpy.types.ViewLayer
, (readonly)
- bpy.context.window
- Type:
bpy.types.Window
, (readonly)
- bpy.context.window_manager
- Type:
bpy.types.WindowManager
, (readonly)
- bpy.context.workspace
- Type:
bpy.types.WorkSpace
, (readonly)
Clip Context
- bpy.context.edit_movieclip
- Type:
- bpy.context.edit_mask
- Type:
File Context
- bpy.context.active_file
- bpy.context.selected_files
- Type:
sequence of
bpy.types.FileSelectEntry
- bpy.context.asset_library_ref
- bpy.context.selected_asset_files
- Type:
sequence of
bpy.types.FileSelectEntry
- bpy.context.id
- Type:
- bpy.context.selected_ids
- Type:
sequence of
bpy.types.ID
Image Context
- bpy.context.edit_image
- Type:
- bpy.context.edit_mask
- Type:
Node Context
- bpy.context.selected_nodes
- Type:
sequence of
bpy.types.Node
- bpy.context.active_node
- Type:
- bpy.context.light
- Type:
- bpy.context.material
- Type:
- bpy.context.world
- Type:
Screen Context
- bpy.context.scene
- Type:
- bpy.context.view_layer
- Type:
- bpy.context.visible_objects
- Type:
sequence of
bpy.types.Object
- bpy.context.selectable_objects
- Type:
sequence of
bpy.types.Object
- bpy.context.selected_objects
- Type:
sequence of
bpy.types.Object
- bpy.context.editable_objects
- Type:
sequence of
bpy.types.Object
- bpy.context.selected_editable_objects
- Type:
sequence of
bpy.types.Object
- bpy.context.objects_in_mode
- Type:
sequence of
bpy.types.Object
- bpy.context.objects_in_mode_unique_data
- Type:
sequence of
bpy.types.Object
- bpy.context.visible_bones
- Type:
sequence of
bpy.types.EditBone
- bpy.context.editable_bones
- Type:
sequence of
bpy.types.EditBone
- bpy.context.selected_bones
- Type:
sequence of
bpy.types.EditBone
- bpy.context.selected_editable_bones
- Type:
sequence of
bpy.types.EditBone
- bpy.context.visible_pose_bones
- Type:
sequence of
bpy.types.PoseBone
- bpy.context.selected_pose_bones
- Type:
sequence of
bpy.types.PoseBone
- bpy.context.selected_pose_bones_from_active_object
- Type:
sequence of
bpy.types.PoseBone
- bpy.context.active_bone
- Type:
- bpy.context.active_pose_bone
- Type:
- bpy.context.active_object
- Type:
- bpy.context.object
- Type:
- bpy.context.edit_object
- Type:
- bpy.context.sculpt_object
- Type:
- bpy.context.vertex_paint_object
- Type:
- bpy.context.weight_paint_object
- Type:
- bpy.context.image_paint_object
- Type:
- bpy.context.particle_edit_object
- Type:
- bpy.context.pose_object
- Type:
- bpy.context.active_sequence_strip
- Type:
- bpy.context.sequences
- Type:
sequence of
bpy.types.Sequence
- bpy.context.selected_sequences
- Type:
sequence of
bpy.types.Sequence
- bpy.context.selected_editable_sequences
- Type:
sequence of
bpy.types.Sequence
- bpy.context.active_nla_track
- Type:
- bpy.context.active_nla_strip
- Type:
- bpy.context.selected_nla_strips
- Type:
sequence of
bpy.types.NlaStrip
- bpy.context.selected_movieclip_tracks
- Type:
sequence of
bpy.types.MovieTrackingTrack
- bpy.context.gpencil_data
- Type:
- bpy.context.gpencil_data_owner
- Type:
- bpy.context.annotation_data
- Type:
- bpy.context.annotation_data_owner
- Type:
- bpy.context.visible_gpencil_layers
- Type:
sequence of
bpy.types.GPencilLayer
- bpy.context.editable_gpencil_layers
- Type:
sequence of
bpy.types.GPencilLayer
- bpy.context.editable_gpencil_strokes
- Type:
sequence of
bpy.types.GPencilStroke
- bpy.context.active_gpencil_layer
- Type:
sequence of
bpy.types.GPencilLayer
- bpy.context.active_gpencil_frame
- Type:
sequence of
bpy.types.GreasePencilLayer
- bpy.context.active_annotation_layer
- Type:
- bpy.context.active_operator
- Type:
- bpy.context.active_action
- Type:
- bpy.context.selected_visible_actions
- Type:
sequence of
bpy.types.Action
- bpy.context.selected_editable_actions
- Type:
sequence of
bpy.types.Action
- bpy.context.visible_fcurves
- Type:
sequence of
bpy.types.FCurve
- bpy.context.editable_fcurves
- Type:
sequence of
bpy.types.FCurve
- bpy.context.selected_visible_fcurves
- Type:
sequence of
bpy.types.FCurve
- bpy.context.selected_editable_fcurves
- Type:
sequence of
bpy.types.FCurve
- bpy.context.active_editable_fcurve
- Type:
- bpy.context.selected_editable_keyframes
- Type:
sequence of
bpy.types.Keyframe
- bpy.context.ui_list
- Type:
- bpy.context.asset_library_ref
Sequencer Context
- bpy.context.edit_mask
- Type:
Text Context
- bpy.context.edit_text
- Type:
View3D Context
- bpy.context.active_object
- Type:
- bpy.context.selected_ids
- Type:
sequence of
bpy.types.ID