> For the complete documentation index, see [llms.txt](https://help.intangible.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.intangible.ai/build/scene-outliner.md).

# Scene Outliner

The panel that lists every object in the scene – lock, hide, pin, rename, duplicate.

A panel that lists every object in the current scene. Lock, hide, pin, rename, or duplicate without ever touching the viewport.

## Watch

<https://www.youtube.com/watch?v=tan2ncQ\\_N5o>

![Scene Outliner panel docked on the left showing object hierarchy in an underwater scene with whale, fish, and mangroves](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-c2823fafede2ae4cd1823498964b2fec3ae9b875%2Fscene-outliner-02.png?alt=media)

## What it does

Five objects in, picking the one you want by clicking the viewport gets slow. Twenty objects in, an object that spawned outside the camera frame is functionally lost – the user-testing notes have plenty of *"I lost my building"* stories to back that up. The Scene Outliner is what fixes it: the panel that lists every object the scene contains, in a tree that mirrors whatever parenting and grouping you've set up. If you've worked in Maya or Blender, it's the same idea – act on items by name and structure instead of hunting in the viewport. Most actions you'd take from the contextual menu of a viewport-selected object are here too, and a few are outliner-only (pin, group-level icon tools, hide-by-row).

## How to use it

In Build mode, open the left rail and click **Project → Scene Outliner**. Open it once and it stays open across project sessions.

1. **Find an object.** Scroll the tree, or hover a row to highlight the object in the viewport. Click the row to select. To search by name, open the search field (its placeholder reads **Find...**); the × beside it empties the field while there is text (**Clear**) and closes it once the field is empty (**Close search**), and `Esc` closes it in one press. Press `F` in the viewport to frame the selection and the outliner scrolls its row into the middle of the panel. With the cursor over the outliner, `F` opens the rows the selection is nested in, scrolls to it and focuses it.
2. **Select more than one.** `Shift`-click a second row to select every row between the two. `Ctrl`-click (`⌘`-click on a Mac) adds a row to the selection or removes it.
3. **Show or hide.** Click the eye icon. The object stays in the scene but disappears from the viewport and from the visualizer's prompt context. Useful for staging shots that don't need every prop in frame.
4. **Lock.** Click the lock icon. A locked object can't be hovered, selected, or transformed in the viewport, but it stays selectable here in the outliner, and its name and description stay editable. Lock the terrain and the populator backbone before you start moving things around, and you'll stop dragging the world by accident. See [Locking objects](https://help.intangible.ai/build/working-with-objects.md#locking-objects).
5. **Pin.** Click the pin icon. Pinned rows stay at the top of the tree as the scene grows. Use it for the few hero objects you keep coming back to.
6. **Rename or edit details.** Right-click a row to open the same details panel you'd get from the viewport: name, description, image reference, LoRA.
7. **Duplicate.** Right-click → Duplicate. The duplicate inherits the original's parent.

### Working with groups

The outliner shows the full tree: groups, sets, populators and objects parented to other objects. A row that holds the selection is tinted, fainter than a selected row, so you can find it when it is collapsed. A group row carries the same per-row icon tools that object rows have: an ellipsis (`...`) menu for Edit Details, Duplicate, and Delete; a visibility toggle (eye); and a lock toggle. Groups start collapsed. Expand one with the disclosure triangle to act on individual children.

**Eye and lock cascade to children.** Click the eye on a group row to hide every editable child in the group at once; click again to show them all. Same for the lock. The cascade is a single undo step, so one Cmd+Z restores the prior state.

**Mixed states resolve to the engaged side.** If any child in a group is visible, the group eye reads open. If any child is locked, the group lock reads engaged. Click the group eye once to hide the rest; click again (now all hidden) to show them all. The mental model is symmetric: any child engaged → group icon engaged → one click toggles all.

**Cameras are skipped by the cascade.** A group containing a camera plus props will hide the props on a group hide; the camera stays untouched.

**Edit Details has a live name preview.** Open Edit Details on a group, type in the name field, and the outliner row text updates per keystroke. The sort position doesn't change while you type; the persisted name only commits when you save the modal. Cancel reverts.

When the populator is expanded, the procedural-instance count shows on the row. Don't try to lock individual procedural instances; lock the populator and adjust its inputs instead. The instances are generated, not authored, and the lock would silently get overridden the next time the populator regenerates.

## Details

| Action     | Where it acts                                                                       |
| ---------- | ----------------------------------------------------------------------------------- |
| Eye / hide | Hides from viewport and from visualizer prompt context                              |
| Lock       | Blocks viewport hover, selection, and transforms; the outliner row stays selectable |
| Pin        | Reorders within the tree only                                                       |
| Rename     | Updates the name fed to the visualizer auto-prompt                                  |
| Duplicate  | Inherits parent, position offset                                                    |

The outliner reflects parent-child attachments live. Drag a row onto another row to re-parent. Drag a row out to the root level to detach.

A yellow triangle on a row means the object didn't make it into the viewport. Hover it for the reason: **Asset failed to load**, or **Not displayed: over the scene limit**. A collapsed group shows the triangle when something inside it has one.

## Limits and known issues

* **Outliner state is per-project.** The hide and pin states don't carry to other projects.
* **Hide doesn't survive a render.** Hidden objects stay out of the prompt context, but if you unhide before generating, they're back in. There's no separate "exclude from render" toggle.
* **Group-level rename isn't propagated to children.** Renaming a populator group changes the group label, not the names of the procedural instances inside it.

## Related

* [Working with objects](https://help.intangible.ai/build/working-with-objects.md)
* [Selection and grouping](https://help.intangible.ai/build/selection-and-grouping.md)
* [Sets](https://help.intangible.ai/build/sets.md)
* [Populators](https://help.intangible.ai/build/populators.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.intangible.ai/build/scene-outliner.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
