Products › Hierarchical Group Outliner
Documentation
Installation
- Download
hierarchy_outliner-1.27.17.zipfrom your Superhive account. Do not unzip it. - In Blender 4.2 or later, drag the zip file into the Blender window and confirm. Or go to Edit › Preferences › Get Extensions, open the menu at the top right, choose Install from Disk… and select the zip.
- Make sure Hierarchical Group Outliner is enabled in the list of extensions.
- In the 3D view, press N to open the sidebar and click the Outliner tab. The same panel is also in Properties › Scene, under the name Hierarchical Group Outliner.
To update, install the new zip the same way: it replaces the previous version.
Getting started in one minute
- Select a few objects and press Ctrl+G: a group appears in the Outliner panel.
- Double-click one of the grouped objects in the 3D view: you are inside the group, in Group Focus.
- Click inside the group: you select its direct children. Double-click again to go one level deeper.
- Press V to switch between Group Focus, Group View and Off.
- Press Backspace to go back up, or click the home button in the panel to return to the root.
The Outliner panel
- Top row: the group you are in, a button to go up (Go Up) and one to return to the root (Exit to Root). While a component is being edited, a Done button replaces them.
- Focus mode: three buttons, only one active: Off (×), Group Focus, Group View.
- The list: one row per object, children under their parent. The triangle folds a branch. Hidden objects stay in the list, greyed; a click makes them the active row without selecting them in the 3D view.
- The outliner's active group (blue square) is the last row you double-clicked. A simple click or a selection in the 3D view does not change it.
- Actions menu (right-click a row): for the 3D view selection, Group, Ungroup, Add to Group…, Leave Group. For the row itself, Add Selection Here, Make Instanceable, Edit Component, New Instance, Detach, Leave Group, Delete. Entries that do not apply are greyed.
Entering groups: the rules
- A double-click on an object activates the ancestor of that object that sits just under the active group (without an active group: its topmost ancestor). That ancestor becomes the active group and you are inside it. One level per double-click; a leaf object is only selected.
- Enter follows the same rule with the active object, which stays the target until you reach it.
- Backspace (Go Up) is an entry into the level above, with the same rules; the group you left becomes the active object. At the root, it leaves all groups.
- On a component instance, the first double-click (or Enter) activates it, the second edits its component.
Add objects to a group
- Add to Group… (Groups menu, Actions menu): pick any group from a searchable list, the active group first.
- Add Selection Here: double-click a group in the Outliner panel to make it the active group, select objects in the 3D view, then right-click the group › Add Selection Here. This also works on an empty Empty.
- Leave Group: the selection moves up one level, to the parent of its group.
- In every case, nothing moves on screen.
Components: the workflow
- Build a group, then right-click it in the Outliner panel › Make Instanceable. Its branch moves to the Components layer (a collection excluded from the view layer) and an instance takes its place, at the same spot and under the same parent.
- Add more instances with New Instance or Shift+A › Component.
- To edit, double-click an instance twice. The first double-click enters it like a group: frame, breadcrumb and outline. The second opens its component: the rest of the scene is hidden in every 3D view and the view frames the source. Objects you add now go into the component.
- While you edit, the breadcrumb starts at the scene and goes through the instance, for example Scene › Street Lamp.001 › Component Street Lamp › Street Lamp. Double-click Scene or the instance to finish editing and go back there.
- To finish, press Backspace at the top of the component, double-click empty space, or click Done. The scene comes back as it was.
- The Components panel lists every component with its instance count (×N). Use the pencil to edit, the bin to delete a component with all its instances (after confirmation), and double-click a name to rename it.
Component sources appear neither in the 3D view, nor in renders, nor in the Outliner panel (except while editing). Deleting an instance keeps its source in the Components layer.
Settings
All settings are in the Feature Toggles panel (under Components) and in the add-on preferences; both show the same options.
| Setting | Choices | Default |
|---|---|---|
| Inside a group, target | Children (direct children only) · All Children (any descendant) | Children |
| On Enter | Group Focus (switch from Off to Group Focus) · Keep Mode | Group Focus |
| Select All on Enter | On · Off | On |
| New objects join the current group | On · Off | On |
| Role Outlines | On · Off, six colours | On |
| Group Frame | On · Off | On |
| Hiding a group hides its contents | On · Off | On |
| Group Keys | G · T · None | G |
| Delete a Group | Whole Group · Like Blender | Whole Group |
| Shortcuts | Enter / Backspace / double-click, Ctrl+W menu, V pie: each on or off | All on |
Shortcuts
In the 3D view, Object Mode. Each one can be turned off in the add-on preferences.
| Shortcut | Action |
|---|---|
| Ctrl+G | Group |
| Ctrl+Alt+G | Ungroup |
| Ctrl+T / Alt+T | Collections: Create New Collection / Remove from Collection (G layout) |
| Ctrl+W | Groups menu (also Object › Groups, and on top of the right-click menu) |
| Enter | Enter the group of the active object, one level per press |
| Backspace | Go up one level |
| Double-click an object | Enter its group, one level per double-click |
| Double-click empty space | Go up one level |
| V | View pie: Group Focus (left), Group View (right), Off (down), Role Outlines (up) |
| Shift+A › Component | Add a component instance at the 3D cursor, in the current group |
| H / Alt+H | Hide (with contents) / reveal all |
| X, Del / Shift+X, Shift+Del | Delete a group with its contents / delete it everywhere |
Changelog
- 1.27.17: bug fixes. Large scenes no longer slow down (a scene of 3000 objects took two seconds per change). Detach works on a hidden or locked instance instead of emptying it. Ungroup no longer fails on nested groups. Making the entered group instanceable keeps the scene selectable. A component opened from inside another one returns to that one when done. Objects keep their shape when grouped under a parent scaled unevenly. Group works on an object also linked in another scene, and double-clicking a group of an excluded collection only selects it.
- 1.27.16: the instance violet is now really violet (hue 0.73 on the color's own values, it was still bluish). The group frame and breadcrumb are drawn in the same shade as the outlines, no longer darker. Inside a component being edited, every outline is violet.
- 1.27.15: Select All on Enter is on by default.
- 1.27.14: the three instance colors share one violet hue (0.73 in Blender's color picker).
- 1.27.13: instances are now clearly violet: the default instance colors were so close to the children's blue that they read as blue. The frame and breadcrumb of a component being edited, and an instance's square in the Outliner panel, are violet too. Old default colors are updated; colors you picked are kept.
- 1.27.12: at the scene root, Backspace or a double-click on empty space says in the status bar that there is nothing to go up to.
- 1.27.11: double-clicking or pressing Enter on an object without children says so in the status bar, instead of doing nothing silently.
- 1.27.10: a new group's Empty is 0.3 m instead of 1 m, so it no longer hides small objects.
- 1.27.9: the Outliner panel, with its Components subpanel, is also in Properties › Scene.
- 1.27.8: the Groups menu (Ctrl+W) is also on top of the right-click menu of the 3D view. The Group Focus wireframe option is gone. The role outlines show what you can select, and the add-on no longer changes how your objects are displayed; objects left in wireframe by an earlier version get their display back.
- 1.27.7: a selected object keeps only Blender's selection outline; the role outline no longer covers it.
- 1.27.6: the add-on is named Hierarchical Group Outliner in Blender.
- 1.27.5: double-clicking an instance no longer picks the object behind it.
- 1.27.4: an entered instance has its frame and breadcrumb in the instance colour.
- 1.27.3: entering an instance shows its frame, breadcrumb and outline, like a group; while a component is edited, the breadcrumb starts at the scene and goes through the instance.
- 1.27.2: objects shown as wireframe or bounds, such as the Group Focus ghosts, no longer hide or stripe the role outlines.
- 1.27.1: the group frame and the role outlines share the same Empty shapes and cache.
- 1.27.0: clickable breadcrumb on the group frame; frame drawn in the Child colour.
- 1.26.0: dashed frame around the active group.
- 1.25.0: breadcrumb of the active group in the 3D view.
- 1.24.3: a group is now an Empty Sphere.
- 1.24.0: role outlines drawn on the GPU, replacing the former Colored mode.