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 [‘EDIT_MESH’, ‘EDIT_CURVE’, ‘EDIT_SURFACE’, ‘EDIT_TEXT’, ‘EDIT_ARMATURE’, ‘EDIT_METABALL’, ‘EDIT_LATTICE’, ‘POSE’, ‘SCULPT’, ‘PAINT_WEIGHT’, ‘PAINT_VERTEX’, ‘PAINT_TEXTURE’, ‘PARTICLE’, ‘OBJECT’, ‘PAINT_GPENCIL’, ‘EDIT_GPENCIL’, ‘SCULPT_GPENCIL’, ‘WEIGHT_GPENCIL’, ‘VERTEX_GPENCIL’], 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)

Screen Context

bpy.context.scene
Type

bpy.types.Scene

bpy.context.view_layer
Type

bpy.types.ViewLayer

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.types.EditBone

bpy.context.active_pose_bone
Type

bpy.types.PoseBone

bpy.context.active_object
Type

bpy.types.Object

bpy.context.object
Type

bpy.types.Object

bpy.context.edit_object
Type

bpy.types.Object

bpy.context.sculpt_object
Type

bpy.types.Object

bpy.context.vertex_paint_object
Type

bpy.types.Object

bpy.context.weight_paint_object
Type

bpy.types.Object

bpy.context.image_paint_object
Type

bpy.types.Object

bpy.context.particle_edit_object
Type

bpy.types.Object

bpy.context.pose_object
Type

bpy.types.Object

bpy.context.active_sequence_strip
Type

bpy.types.Sequence

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.types.NlaTrack

bpy.context.active_nla_strip
Type

bpy.types.NlaStrip

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.types.GreasePencil

bpy.context.gpencil_data_owner
Type

bpy.types.ID

bpy.context.annotation_data
Type

bpy.types.GreasePencil

bpy.context.annotation_data_owner
Type

bpy.types.ID

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.types.GPencilLayer

bpy.context.active_operator
Type

bpy.types.Operator

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.types.FCurve

bpy.context.selected_editable_keyframes
Type

sequence of bpy.types.Keyframe

bpy.context.ui_list
Type

bpy.types.UIList

bpy.context.asset_library_ref
Type

bpy.types.AssetLibraryReference

View3D Context

bpy.context.active_object
Type

bpy.types.Object

bpy.context.selected_ids
Type

sequence of bpy.types.ID

Buttons Context

bpy.context.texture_slot
Type

bpy.types.MaterialTextureSlot

bpy.context.scene
Type

bpy.types.Scene

bpy.context.world
Type

bpy.types.World

bpy.context.object
Type

bpy.types.Object

bpy.context.mesh
Type

bpy.types.Mesh

bpy.context.armature
Type

bpy.types.Armature

bpy.context.lattice
Type

bpy.types.Lattice

bpy.context.curve
Type

bpy.types.Curve

bpy.context.meta_ball
Type

bpy.types.MetaBall

bpy.context.light
Type

bpy.types.Light

bpy.context.speaker
Type

bpy.types.Speaker

bpy.context.lightprobe
Type

bpy.types.LightProbe

bpy.context.camera
Type

bpy.types.Camera

bpy.context.material
Type

bpy.types.Material

bpy.context.material_slot
Type

bpy.types.MaterialSlot

bpy.context.texture
Type

bpy.types.Texture

bpy.context.texture_user
Type

bpy.types.ID

bpy.context.texture_user_property
Type

bpy.types.Property

bpy.context.bone
Type

bpy.types.Bone

bpy.context.edit_bone
Type

bpy.types.EditBone

bpy.context.pose_bone
Type

bpy.types.PoseBone

bpy.context.particle_system
Type

bpy.types.ParticleSystem

bpy.context.particle_system_editable
Type

bpy.types.ParticleSystem

bpy.context.particle_settings
Type

bpy.types.ParticleSettings

bpy.context.cloth
Type

bpy.types.ClothModifier

bpy.context.soft_body
Type

bpy.types.SoftBodyModifier

bpy.context.fluid
Type

bpy.types.FluidSimulationModifier

bpy.context.collision
Type

bpy.types.CollisionModifier

bpy.context.brush
Type

bpy.types.Brush

bpy.context.dynamic_paint
Type

bpy.types.DynamicPaintModifier

bpy.context.line_style
Type

bpy.types.FreestyleLineStyle

bpy.context.collection
Type

bpy.types.LayerCollection

bpy.context.gpencil
Type

bpy.types.GreasePencil

bpy.context.volume
Type

bpy.types.Volume

Image Context

bpy.context.edit_image
Type

bpy.types.Image

bpy.context.edit_mask
Type

bpy.types.Mask

Node Context

bpy.context.selected_nodes
Type

sequence of bpy.types.Node

bpy.context.active_node
Type

bpy.types.Node

bpy.context.light
Type

bpy.types.Light

bpy.context.material
Type

bpy.types.Material

bpy.context.world
Type

bpy.types.World

Text Context

bpy.context.edit_text
Type

bpy.types.Text

Clip Context

bpy.context.edit_movieclip
Type

bpy.types.MovieClip

bpy.context.edit_mask
Type

bpy.types.Mask

Sequencer Context

bpy.context.edit_mask
Type

bpy.types.Mask

File Context

bpy.context.active_file
Type

bpy.types.FileSelectEntry

bpy.context.selected_files
Type

sequence of bpy.types.FileSelectEntry

bpy.context.asset_library_ref
Type

bpy.types.AssetLibraryReference

bpy.context.selected_asset_files
Type

sequence of bpy.types.FileSelectEntry

bpy.context.id
Type

bpy.types.ID