Outliner Operators

bpy.ops.outliner.action_set(action='')

Change the active action used

Parameters

action (enum in [], (optional)) – Action

bpy.ops.outliner.animdata_operation(type='CLEAR_ANIMDATA')

Undocumented, consider contributing.

Parameters

type (enum in ['CLEAR_ANIMDATA', 'SET_ACT', 'CLEAR_ACT', 'REFRESH_DRIVERS', 'CLEAR_DRIVERS'], (optional)) –

Animation Operation

  • CLEAR_ANIMDATA Clear Animation Data, Remove this animation data container.

  • SET_ACT Set Action.

  • CLEAR_ACT Unlink Action.

  • REFRESH_DRIVERS Refresh Drivers.

  • CLEAR_DRIVERS Clear Drivers.

bpy.ops.outliner.collection_color_tag_set(color='NONE')

Set a color tag for the selected collections

Parameters

color (enum in ['NONE', 'COLOR_01', 'COLOR_02', 'COLOR_03', 'COLOR_04', 'COLOR_05', 'COLOR_06', 'COLOR_07', 'COLOR_08'], (optional)) –

Color Tag

  • NONE None, Assign no color tag to the collection.

  • COLOR_01 Color 01.

  • COLOR_02 Color 02.

  • COLOR_03 Color 03.

  • COLOR_04 Color 04.

  • COLOR_05 Color 05.

  • COLOR_06 Color 06.

  • COLOR_07 Color 07.

  • COLOR_08 Color 08.

bpy.ops.outliner.collection_disable()

Disable viewport display in the view layers

bpy.ops.outliner.collection_disable_render()

Do not render this collection

bpy.ops.outliner.collection_drop()

Drag to move to collection in Outliner

bpy.ops.outliner.collection_duplicate()

Recursively duplicate the collection, all its children, objects and object data

bpy.ops.outliner.collection_duplicate_linked()

Recursively duplicate the collection, all its children and objects, with linked object data

bpy.ops.outliner.collection_enable()

Enable viewport display in the view layers

bpy.ops.outliner.collection_enable_render()

Render the collection

bpy.ops.outliner.collection_exclude_clear()

Include collection in the active view layer

bpy.ops.outliner.collection_exclude_set()

Exclude collection from the active view layer

bpy.ops.outliner.collection_hide()

Hide the collection in this view layer

bpy.ops.outliner.collection_hide_inside()

Hide all the objects and collections inside the collection

bpy.ops.outliner.collection_hierarchy_delete()

Delete selected collection hierarchies

bpy.ops.outliner.collection_holdout_clear()

Clear masking of collection in the active view layer

bpy.ops.outliner.collection_holdout_set()

Mask collection in the active view layer

bpy.ops.outliner.collection_indirect_only_clear()

Clear collection contributing only indirectly in the view layer

bpy.ops.outliner.collection_indirect_only_set()

Set collection to only contribute indirectly (through shadows and reflections) in the view layer

bpy.ops.outliner.collection_instance()

Instance selected collections to active scene

bpy.ops.outliner.collection_isolate(extend=False)

Hide all but this collection and its parents

Parameters

extend (boolean, (optional)) – Extend, Extend current visible collections

Link selected collections to active scene

bpy.ops.outliner.collection_new(nested=True)

Add a new collection inside selected collection

Parameters

nested (boolean, (optional)) – Nested, Add as child of selected collection

bpy.ops.outliner.collection_objects_deselect()

Deselect objects in collection

bpy.ops.outliner.collection_objects_select()

Select objects in collection

bpy.ops.outliner.collection_show()

Show the collection in this view layer

bpy.ops.outliner.collection_show_inside()

Show all the objects and collections inside the collection

bpy.ops.outliner.constraint_operation(type='ENABLE')

Undocumented, consider contributing.

Parameters

type (enum in ['ENABLE', 'DISABLE', 'DELETE'], (optional)) – Constraint Operation

bpy.ops.outliner.data_operation(type='SELECT')

Undocumented, consider contributing.

Parameters

type (enum in ['SELECT', 'DESELECT', 'HIDE', 'UNHIDE', 'SELECT_LINKED'], (optional)) – Data Operation

bpy.ops.outliner.datastack_drop()

Copy or reorder modifiers, constraints, and effects

bpy.ops.outliner.delete(hierarchy=False)

Delete selected objects and collections

Parameters

hierarchy (boolean, (optional)) – Hierarchy, Delete child objects and collections

bpy.ops.outliner.drivers_add_selected()

Add drivers to selected items

bpy.ops.outliner.drivers_delete_selected()

Delete drivers assigned to selected items

bpy.ops.outliner.expanded_toggle()

Expand/Collapse all items

bpy.ops.outliner.hide()

Hide selected objects and collections

bpy.ops.outliner.highlight_update()

Update the item highlight based on the current mouse position

bpy.ops.outliner.id_copy()

Selected data-blocks are copied to the clipboard

bpy.ops.outliner.id_delete()

Delete the ID under cursor

bpy.ops.outliner.id_operation(type='UNLINK')

Undocumented, consider contributing.

Parameters

type (enum in ['UNLINK', 'MARK_ASSET', 'CLEAR_ASSET', 'LOCAL', 'SINGLE', 'DELETE', 'REMAP', 'OVERRIDE_LIBRARY_CREATE', 'OVERRIDE_LIBRARY_CREATE_HIERARCHY', 'OVERRIDE_LIBRARY_PROXY_CONVERT', 'OVERRIDE_LIBRARY_RESET', 'OVERRIDE_LIBRARY_RESET_HIERARCHY', 'OVERRIDE_LIBRARY_RESYNC_HIERARCHY', 'OVERRIDE_LIBRARY_RESYNC_HIERARCHY_ENFORCE', 'OVERRIDE_LIBRARY_DELETE_HIERARCHY', 'COPY', 'PASTE', 'ADD_FAKE', 'CLEAR_FAKE', 'RENAME', 'SELECT_LINKED'], (optional)) –

ID Data Operation

  • UNLINK Unlink.

  • MARK_ASSET Mark Asset.

  • CLEAR_ASSET Clear Asset.

  • LOCAL Make Local.

  • SINGLE Make Single User.

  • DELETE Delete.

  • REMAP Remap Users, Make all users of selected data-blocks to use instead current (clicked) one.

  • OVERRIDE_LIBRARY_CREATE Make Library Override, Make a local override of this linked data-block.

  • OVERRIDE_LIBRARY_CREATE_HIERARCHY Make Library Override Hierarchy, Make a local override of this linked data-block, and its hierarchy of dependencies.

  • OVERRIDE_LIBRARY_PROXY_CONVERT Convert Proxy to Override, Convert a Proxy object to a full library override, including all its dependencies.

  • OVERRIDE_LIBRARY_RESET Reset Library Override, Reset this local override to its linked values.

  • OVERRIDE_LIBRARY_RESET_HIERARCHY Reset Library Override Hierarchy, Reset this local override to its linked values, as well as its hierarchy of dependencies.

  • OVERRIDE_LIBRARY_RESYNC_HIERARCHY Resync Library Override Hierarchy, Rebuild this local override from its linked reference, as well as its hierarchy of dependencies.

  • OVERRIDE_LIBRARY_RESYNC_HIERARCHY_ENFORCE Resync Library Override Hierarchy Enforce, Rebuild this local override from its linked reference, as well as its hierarchy of dependencies, enforcing that hierarchy to match the linked data (i.e. ignoring exiting overrides on data-blocks pointer properties).

  • OVERRIDE_LIBRARY_DELETE_HIERARCHY Delete Library Override Hierarchy, Delete this local override (including its hierarchy of override dependencies) and relink its usages to the linked data-blocks.

  • COPY Copy.

  • PASTE Paste.

  • ADD_FAKE Add Fake User, Ensure data-block gets saved even if it isn’t in use (e.g. for motion and material libraries).

  • CLEAR_FAKE Clear Fake User.

  • RENAME Rename.

  • SELECT_LINKED Select Linked.

bpy.ops.outliner.id_paste()

Data-blocks from the clipboard are pasted

bpy.ops.outliner.id_remap(id_type='OBJECT', old_id='', new_id='')

Undocumented, consider contributing.

Parameters

  • id_type (enum in ['ACTION', 'ARMATURE', 'BRUSH', 'CAMERA', 'CACHEFILE', 'CURVE', 'FONT', 'GREASEPENCIL', 'COLLECTION', 'IMAGE', 'KEY', 'LIGHT', 'LIBRARY', 'LINESTYLE', 'LATTICE', 'MASK', 'MATERIAL', 'META', 'MESH', 'MOVIECLIP', 'NODETREE', 'OBJECT', 'PAINTCURVE', 'PALETTE', 'PARTICLE', 'LIGHT_PROBE', 'SCENE', 'SIMULATION', 'SOUND', 'SPEAKER', 'TEXT', 'TEXTURE', 'HAIR', 'POINTCLOUD', 'VOLUME', 'WINDOWMANAGER', 'WORLD', 'WORKSPACE'], (optional)) – ID Type

  • old_id (enum in [], (optional)) – Old ID, Old ID to replace

  • new_id (enum in [], (optional)) – New ID, New ID to remap all selected IDs’ users to

bpy.ops.outliner.item_activate(extend=True, extend_range=False, deselect_all=False)

Handle mouse clicks to select and activate items

Parameters

  • extend (boolean, (optional)) – Extend, Extend selection for activation

  • extend_range (boolean, (optional)) – Extend Range, Select a range from active element

  • deselect_all (boolean, (optional)) – Deselect On Nothing, Deselect all when nothing under the cursor

bpy.ops.outliner.item_drag_drop()

Drag and drop element to another place

bpy.ops.outliner.item_openclose(all=False)

Toggle whether item under cursor is enabled or closed

Parameters

all (boolean, (optional)) – All, Close or open all items

bpy.ops.outliner.item_rename(use_active=False)

Rename the active element

Parameters

use_active (boolean, (optional)) – Use Active, Rename the active item, rather than the one the mouse is over

bpy.ops.outliner.keyingset_add_selected()

Add selected items (blue-gray rows) to active Keying Set

bpy.ops.outliner.keyingset_remove_selected()

Remove selected items (blue-gray rows) from active Keying Set

bpy.ops.outliner.lib_operation(type='RENAME')

Undocumented, consider contributing.

Parameters

type (enum in ['RENAME', 'DELETE', 'RELOCATE', 'RELOAD'], (optional)) –

Library Operation

  • RENAME Rename.

  • DELETE Delete, Delete this library and all its item. Warning: No undo.

  • RELOCATE Relocate, Select a new path for this library, and reload all its data.

  • RELOAD Reload, Reload all data from this library.

bpy.ops.outliner.lib_relocate()

Relocate the library under cursor

bpy.ops.outliner.material_drop()

Drag material to object in Outliner

bpy.ops.outliner.modifier_operation(type='TOGVIS')

Undocumented, consider contributing.

Parameters

type (enum in ['TOGVIS', 'TOGREN', 'DELETE'], (optional)) – Modifier Operation

bpy.ops.outliner.object_operation(type='SELECT')

Undocumented, consider contributing.

Parameters

type (enum in ['SELECT', 'DESELECT', 'SELECT_HIERARCHY', 'REMAP', 'RENAME', 'OBJECT_PROXY_TO_OVERRIDE'], (optional)) –

Object Operation

  • SELECT Select.

  • DESELECT Deselect.

  • SELECT_HIERARCHY Select Hierarchy.

  • REMAP Remap Users, Make all users of selected data-blocks to use instead a new chosen one.

  • RENAME Rename.

  • OBJECT_PROXY_TO_OVERRIDE Convert Proxy to Override, Convert a Proxy object to a full library override, including all its dependencies.

bpy.ops.outliner.operation()

Context menu for item operations

bpy.ops.outliner.orphans_purge(num_deleted=0, do_local_ids=True, do_linked_ids=True, do_recursive=False)

Clear all orphaned data-blocks without any users from the file

Parameters

  • do_local_ids (boolean, (optional)) – Local Data-blocks, Include unused local data-blocks into deletion

  • do_linked_ids (boolean, (optional)) – Linked Data-blocks, Include unused linked data-blocks into deletion

  • do_recursive (boolean, (optional)) – Recursive Delete, Recursively check for indirectly unused data-blocks, ensuring that no orphaned data-blocks remain after execution

bpy.ops.outliner.parent_clear()

Drag to clear parent in Outliner

bpy.ops.outliner.parent_drop()

Drag to parent in Outliner

bpy.ops.outliner.scene_drop()

Drag object to scene in Outliner

bpy.ops.outliner.scene_operation(type='DELETE')

Context menu for scene operations

Parameters

type (enum in ['DELETE'], (optional)) – Scene Operation

bpy.ops.outliner.scroll_page(up=False)

Scroll page up or down

Parameters

up (boolean, (optional)) – Up, Scroll up one page

bpy.ops.outliner.select_all(action='TOGGLE')

Toggle the Outliner selection of items

Parameters

action (enum in ['TOGGLE', 'SELECT', 'DESELECT', 'INVERT'], (optional)) –

Action, Selection action to execute

  • TOGGLE Toggle, Toggle selection for all elements.

  • SELECT Select, Select all elements.

  • DESELECT Deselect, Deselect all elements.

  • INVERT Invert, Invert selection of all elements.

bpy.ops.outliner.select_box(tweak=False, xmin=0, xmax=0, ymin=0, ymax=0, wait_for_input=True, mode='SET')

Use box selection to select tree elements

Parameters

  • tweak (boolean, (optional)) – Tweak, Tweak gesture from empty space for box selection

  • xmin (int in [-inf, inf], (optional)) – X Min

  • xmax (int in [-inf, inf], (optional)) – X Max

  • ymin (int in [-inf, inf], (optional)) – Y Min

  • ymax (int in [-inf, inf], (optional)) – Y Max

  • wait_for_input (boolean, (optional)) – Wait for Input

  • mode (enum in ['SET', 'ADD', 'SUB'], (optional)) –

    Mode

    • SET Set, Set a new selection.

    • ADD Extend, Extend existing selection.

    • SUB Subtract, Subtract existing selection.

bpy.ops.outliner.select_walk(direction='UP', extend=False, toggle_all=False)

Use walk navigation to select tree elements

Parameters

  • direction (enum in ['UP', 'DOWN', 'LEFT', 'RIGHT'], (optional)) – Walk Direction, Select/Deselect element in this direction

  • extend (boolean, (optional)) – Extend, Extend selection on walk

  • toggle_all (boolean, (optional)) – Toggle All, Toggle open/close hierarchy

bpy.ops.outliner.show_active()

Open up the tree and adjust the view so that the active object is shown centered

bpy.ops.outliner.show_hierarchy()

Open all object entries and close all others

bpy.ops.outliner.show_one_level(open=True)

Expand/collapse all entries by one level

Parameters

open (boolean, (optional)) – Open, Expand all entries one level deep

bpy.ops.outliner.unhide_all()

Unhide all objects and collections