update Open Source Docs from Roblox internal teams

rbx-open-source-docs[bot] · rbx-open-source-docs[bot] · commit f9b99ffa22a4 · 2025-06-23T17:38:56.000Z
diff --git a/content/en-us/assets/studio/explorer/Branch-Expanded.png b/content/en-us/assets/studio/explorer/Branch-Expanded.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:5b4cac412177717ffe54770eb4f370e7f2da6c6b8dd9c8966f71b228416142eb
-size 49910
+oid sha256:a76202a113c1c79ce622037f37d5b8b2063732fc5b8c1303a39813872e05a072
+size 127358
diff --git a/content/en-us/assets/studio/explorer/Context-Menu-Model.png b/content/en-us/assets/studio/explorer/Context-Menu-Model.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b58c67d9dc86208b77d9e44f450a7e89eff001103aa6e0a8634eb98511efd8ce
+size 173611
diff --git a/content/en-us/assets/studio/explorer/Context-Menu-Service.png b/content/en-us/assets/studio/explorer/Context-Menu-Service.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:494313f4ac4fcd09df4b1fef2c219eaae93246d7a4242baaedd974cb766203d0
+size 159669
diff --git a/content/en-us/assets/studio/explorer/Drag-Select-Searched.png b/content/en-us/assets/studio/explorer/Drag-Select-Searched.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:28f872705549e959ca0667b618de2024f990567f386d143a157b840599ee7f5b
-size 66885
+oid sha256:073a118d1a0488c5fa9a9671c7ee9952d0bde04d26593d93dfad288949e1a78b
+size 80337
diff --git a/content/en-us/assets/studio/explorer/Folder-Children.png b/content/en-us/assets/studio/explorer/Folder-Children.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:56e2313f46738e16c1308cdfcbd71fdd40b61b65625ae0f7bc30bdf44433d58d
-size 31239
+oid sha256:6d0e4627b2daada1aba70f2148c46270d6061119d9a007dc3542cc193e7a7339
+size 67882
diff --git a/content/en-us/assets/studio/explorer/Insert-Object-Options.png b/content/en-us/assets/studio/explorer/Insert-Object-Options.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:cc74c1268461b7470772816de42df7f40daf73dcfc041d49b6b8db3ef16f746f
-size 21666
+oid sha256:6d96687b51326baae876ea904e8cb78c47b27d3575398acd605d661edac4e49a
+size 25253
diff --git a/content/en-us/assets/studio/explorer/Parent-Child-Hierarchy.png b/content/en-us/assets/studio/explorer/Parent-Child-Hierarchy.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:63ad8535e3616757aaf8902c8a2a47cfc839ba0033323bd85aa96d108965678f
-size 47669
+oid sha256:31b3d816422edd3e6ae431c62cef21ba4651af26fb3f97361f11b322d7d9793c
+size 149255
diff --git a/content/en-us/assets/studio/explorer/Reparent-Object.png b/content/en-us/assets/studio/explorer/Reparent-Object.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:c4fcef1f43ffb11fde65eada46bc1faa9ce5606e03ed80192021f328d90383f7
-size 43317
+oid sha256:cbe7ae4b4d9a906159e87c88d1809fa64bfd67cd04abb1c2b28ae42ba88206b8
+size 47398
diff --git a/content/en-us/assets/studio/explorer/Search-By-Name.png b/content/en-us/assets/studio/explorer/Search-By-Name.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:c7e4ec4f0a78c7568db5de50339a4e54de86fe25c0f1d6a2b5f00ddc23859453
-size 29967
+oid sha256:a8e72b77b00482c4eb9f17307bffa3eb4503d2a82f187721bcd82aab2c16b58c
+size 135818
diff --git a/content/en-us/assets/studio/explorer/Search-Diagram.png b/content/en-us/assets/studio/explorer/Search-Diagram.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:bc5cb95776a050b349eafcbcefe37e3b3ab6baafb8a05ea98a949ea7952ddbc7
-size 52425
+oid sha256:96b41852ed72a02c9d4dfe2696cfc61671d7600117333db4a75c0ce2c9319fd3
+size 102112
diff --git a/content/en-us/assets/studio/explorer/Select-All-Searched.png b/content/en-us/assets/studio/explorer/Select-All-Searched.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:c8b494660c4ee601838c5905af9ee6246e264431eb6e13f939b28b0096ad778e
-size 30898
+oid sha256:0cb6081a680997ec4d60f896c70131d5c9ba0161f4813c01afcb0d5f6a856791
+size 56163
diff --git a/content/en-us/assets/studio/explorer/Shift-Click-Non-Searched-A.png b/content/en-us/assets/studio/explorer/Shift-Click-Non-Searched-A.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:79ac911d2cd6dc891fb9978932c3b70075aa329a190f72519b7c0d9651e03e84
+size 110790
diff --git a/content/en-us/assets/studio/explorer/Shift-Click-Non-Searched-B.png b/content/en-us/assets/studio/explorer/Shift-Click-Non-Searched-B.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:85a66cd203df3ea97ad242e9554ae6ba1e12c105ec1d60d23c0122eb3f4476d8
+size 114156
diff --git a/content/en-us/assets/studio/explorer/Shift-Click-Searched.png b/content/en-us/assets/studio/explorer/Shift-Click-Searched.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:479d2fdc494a5a9dfefd8b92ed6f4a8bba777239338d8bdb56ae6fdfd78870a2
-size 64689
+oid sha256:e1dacdd421f1f63b71ffe17afe88db3cac591d665ee5c46c7c60611f6026fdbe
+size 84578
diff --git a/content/en-us/assets/studio/explorer/Workspace-Add-Object.png b/content/en-us/assets/studio/explorer/Workspace-Add-Object.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8ec1b282c5c0423641b3c9d4df850647277beaf9dda952fefa1eb736e9e08437
-size 39531
+oid sha256:6645a0fd855fc8d3bcef08ed8e3e04eb5b7254380241ef84b622e51fb7ba742c
+size 43325
diff --git a/content/en-us/studio/explorer.md b/content/en-us/studio/explorer.md
@@ -9,19 +9,17 @@ The **Explorer** window shows a hierarchical list of every instance inside an ex
 
 ## Parent-child hierarchy
 
-All children of a parent object appear under its branch when expanded. Click the arrow next to a parent branch (or press <kbd>&rarr;</kbd>/<kbd>&larr;</kbd> when a parent is selected) to expand/collapse only that branch.
+All children of a parent object appear under its branch when expanded. Click the arrow next to a parent branch&nbsp;— or press the <kbd>&rarr;</kbd>/<kbd>&larr;</kbd> arrow keys when a parent is selected&nbsp;— to expand/collapse only that branch.
 
 <Grid container spacing={3}>
 <Grid item>
 <figure>
 <img src="../assets/studio/explorer/Parent-Child-Hierarchy.png" width="320" alt="Explorer hierarchy showing Camera, Terrain, and SignModel as children of Workspace; Board and Post as children of SignModel" />
-<figcaption>Hierarchy of nested objects</figcaption>
 </figure>
 </Grid>
 <Grid item>
 <figure>
 <img src="../assets/studio/explorer/Branch-Expanded.png" width="320" alt="Only the topmost parent expanded with click" />
-<figcaption>Arrow or <kbd>&rarr;</kbd>/<kbd>&larr;</kbd> expands/collapses a branch</figcaption>
 </figure>
 </Grid>
 </Grid>
@@ -106,6 +104,23 @@ Objects can be quickly duplicated into the same branch, while items copied to th
 When pasting 3D objects copied to the clipboard, you can maintain their original `Datatype.CFrame` position by right‑clicking the target parent instance in the hierarchy and selecting **Paste&nbsp;Options**&nbsp;&rang; **Paste&nbsp;Into&nbsp;At&nbsp;Original&nbsp;Location**.
 </Alert>
 
+## Contextual options
+
+Right-clicking on an instance opens the options menu, contextually adjusted for the object type. For example, right‑clicking a `Class.Model` reveals standard options like **Copy** and **Duplicate**, and also options specific to `Class.Model|Models` like **Ungroup**. In contrast, right‑clicking a service like `Class.Lighting` reveals a more concise menu of actions valid for services.
+
+<Grid container spacing={3}>
+<Grid item>
+<figure>
+<img src="../assets/studio/explorer/Context-Menu-Model.png" width="320" />
+</figure>
+</Grid>
+<Grid item>
+<figure>
+<img src="../assets/studio/explorer/Context-Menu-Service.png" width="320" />
+</figure>
+</Grid>
+</Grid>
+
 ## Folder organization
 
 Like directories/folders on a computer, the `Class.Folder` object is a useful way to organize objects. For instance, if you want to store all environmental audio assets in a logical place, you can create a folder and place multiple `Class.AudioPlayer` objects within it.
@@ -350,23 +365,45 @@ Within a [searched](#search-methods) hierarchy, certain key shortcuts and mouse
 
 ### Select all
 
-Within a non‑searched hierarchy, pressing <kbd>Ctrl</kbd><kbd>A</kbd> on Windows or <kbd>⌘</kbd><kbd>A</kbd> on macOS selects all instances. Within a [searched](#search-methods) hierarchy, the same shortcut or the **select&nbsp;all** button selects only the query‑matching objects.
+Within a non‑searched hierarchy, pressing <kbd>Ctrl</kbd><kbd>A</kbd> on Windows or <kbd>⌘</kbd><kbd>A</kbd> on macOS selects all instances. Within a [searched](#search-methods) hierarchy, the same shortcut or the **select&nbsp;all** button selects only the query‑matching objects, for example all objects matching **Board** in a hierarchy searched for `board`.
 
-<figure>
 <img src="../assets/studio/explorer/Select-All-Searched.png" width="320" alt="Image showing how only matching objects are selected in a searched hierarchy using the Select All shortcut" />
-</figure>
 
 ### Shift-select
 
-Within a non-searched hierarchy, clicking an object and <kbd>Shift</kbd>-clicking another object selects every parent in the range. Within a [searched](#search-methods) hierarchy, if both the initially‑clicked object **and** the <kbd>Shift</kbd>‑clicked object match the query, only query‑matching objects between are selected.
+Clicking an object and <kbd>Shift</kbd>-clicking another object behaves differently within a non‑searched hierarchy versus a [searched](#search-methods) hierarchy.
+
+<Tabs>
+<TabItem label="Non-Searched Hierarchy">
+Within a non-searched hierarchy, <kbd>Shift</kbd>-clicking two objects at the same hierarchy level selects both of them and every object between which is also at the same hierarchy level, as shown in image **🅰** where **LeftFoot** is initially clicked, **LeftLowerArm** is <kbd>Shift</kbd>‑clicked, and **LeftHand** at same hierarchy level is also selected. Duplicating, copying, or pasting the selected objects will result in a deep copy of those objects **and** all children.
+
+If the first <kbd>Shift</kbd>-clicked object and the second <kbd>Shift</kbd>-clicked object are at **different** hierarchy levels, all objects in between them will be selected, as shown in image **🅱** where **LeftFoot** is initially clicked, **LeftHand** is <kbd>Shift</kbd>‑clicked, and everything between is also selected.
 
+<Grid container spacing={3}>
+<Grid item>
 <figure>
-<img src="../assets/studio/explorer/Shift-Click-Searched.png" width="320" alt="Image showing how only matching objects in range are selected within a searched hierarchy" />
+<img src="../assets/studio/explorer/Shift-Click-Non-Searched-A.png" width="320" />
+<figcaption><kbd>Shift</kbd>-click at same hierarchy level</figcaption>
+</figure>
+</Grid>
+<Grid item>
+<figure>
+<img src="../assets/studio/explorer/Shift-Click-Non-Searched-B.png" width="320" />
+<figcaption><kbd>Shift</kbd>-click at different hierarchy level</figcaption>
 </figure>
+</Grid>
+</Grid>
+</TabItem>
+<TabItem label="Searched Hierarchy">
+Within a searched hierarchy, if both the initially‑clicked object and the <kbd>Shift</kbd>‑clicked object match the query, only query‑matching objects between are selected. For example, in the following image with a hierarchy searched for `anim`, **FallAnim** is initially clicked, **RunAnim** is <kbd>Shift</kbd>‑clicked, and every object matching `anim` between is also selected.
+
+<img src="../assets/studio/explorer/Shift-Click-Searched.png" width="320" alt="Image showing how only matching objects in range are selected within a searched hierarchy" />
+</TabItem>
+</Tabs>
 
 ### Drag select
 
-Clicking and dragging from the right side of the window initiates a selection box. Within a non‑searched hierarchy, everything inside the box is selected. Within a [searched](#search-methods) hierarchy, only query‑matching objects inside the box are selected.
+Clicking and dragging from an empty region of the window initiates a selection box. Within a non‑searched hierarchy, everything inside the box is selected. Within a [searched](#search-methods) hierarchy, only query‑matching objects inside the box are selected.
 
 <figure>
 <img src="../assets/studio/explorer/Drag-Select-Searched.png" width="320" alt="Image showing how only matching objects inside the selection box are selected within a searched hierarchy" />
