update Open Source Docs from Roblox internal teams

rbx-open-source-docs[bot] · rbx-open-source-docs[bot] · commit 374f094f9f1b · 2025-10-23T19:15:24.000Z
diff --git a/content/en-us/assets/studio/properties/Add-Attribute-Button.png b/content/en-us/assets/studio/properties/Add-Attribute-Button.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:a69f91b23710f45bb65df473b2ff84a8b63dbf3857449184afe61ef3d1685e1c
-size 10745
+oid sha256:647b53d11b871880ba3c1af0fb016cf8c50b35c59989f9dd5c5a019e1d6bb466
+size 11910
diff --git a/content/en-us/assets/studio/properties/Add-Tag-Button.png b/content/en-us/assets/studio/properties/Add-Tag-Button.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:4ed3553192ecd09a5e822fa0c9a4bf890940b9df011462f8c22483e7d7043668
-size 9867
+oid sha256:10924a4b351a4ca2d7ba5188f09c9517dc04e4643a055013d403348ba85f2ba7
+size 10444
diff --git a/content/en-us/assets/studio/properties/Default-Properties-Toast.jpg b/content/en-us/assets/studio/properties/Default-Properties-Toast.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:fede6d6ae95526b6ffadea0f2c189d42d7821efbbf93182b4a296a42598ded9b
+size 303241
diff --git a/content/en-us/assets/studio/properties/Header-Example-A.png b/content/en-us/assets/studio/properties/Header-Example-A.png
diff --git a/content/en-us/assets/studio/properties/Header-Example-B.png b/content/en-us/assets/studio/properties/Header-Example-B.png
diff --git a/content/en-us/assets/studio/properties/Input-Combined.png b/content/en-us/assets/studio/properties/Input-Combined.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:1668fce8a3c544760d55b120c568239468cb228854f5a7c14b2284030bb0850b
-size 13816
+oid sha256:eead5e1bff5970cf0db92781d91cc24e24d3e6b12c6d26839ada0ef4479eaf9f
+size 18854
diff --git a/content/en-us/assets/studio/properties/Input-Expanded.png b/content/en-us/assets/studio/properties/Input-Expanded.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:a82269064dabfe8a9869f3e60763b827867b6e51fb962b04ef1970e2d3862cdc
-size 11238
+oid sha256:2ce4036c0e0fdf14d024ace153e082590653f8325b5c16f8259e34a16880ee4a
+size 11209
diff --git a/content/en-us/assets/studio/properties/Instance-Filtered.png b/content/en-us/assets/studio/properties/Instance-Filtered.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e9a839a1ea3caed21d9f0449ea774ba3360cc44a7ad1f90e0525b6ceff03750e
-size 21894
+oid sha256:885aff7586e1d11337161e50ceac1bfec0bb11026cbf9a7f4f43801761950d1d
+size 24145
diff --git a/content/en-us/assets/studio/properties/MeshPart-General.png b/content/en-us/assets/studio/properties/MeshPart-General.png
diff --git a/content/en-us/assets/studio/properties/Remove-Tag-Button.png b/content/en-us/assets/studio/properties/Remove-Tag-Button.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:43495d71715cdbdb7c6fc4c577ff77bd2dac22382b4dca8f42967c1dd508f05c
-size 11227
+oid sha256:bde7495ea3a0e28e54816bf7d1e22badc98c31dc8e87ab1ce5f8e57ed6e83d62
+size 10663
diff --git a/content/en-us/assets/studio/properties/Rename-Delete-Attribute-Button.png b/content/en-us/assets/studio/properties/Rename-Delete-Attribute-Button.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:6b9e253a7a80fc10166ece09918292ce6405b803475855864258b1e4684f7d2a
-size 11737
+oid sha256:9d7adcdbfa96546f33567db79f5f9a667634f1abec8e069cfc520f1340905212
+size 11499
diff --git a/content/en-us/assets/studio/properties/Section-Expand-Collapse.png b/content/en-us/assets/studio/properties/Section-Expand-Collapse.png
diff --git a/content/en-us/assets/studio/properties/Sections-Example.png b/content/en-us/assets/studio/properties/Sections-Example.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8ddec3fa9d98b82ca16107c69c3a1c52d4763a615c6fce81a9463b27faae1bb6
-size 72463
+oid sha256:8add4bb75ebc637b9c4ce10afa2c59ff083b60bc5f820f27d5ef83f2757a2a9d
+size 113358
diff --git a/content/en-us/assets/studio/properties/Set-Attribute.png b/content/en-us/assets/studio/properties/Set-Attribute.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:6e27a0c7d133bd8171fa4edfba5e56d4892c1e1e1dc8a7380e0d5d0aef05ea66
-size 6855
+oid sha256:cffe4ff44e5c57515364d6c8e1edd30beb0b789341fd911e7dd9225a3715ef97
+size 7875
diff --git a/content/en-us/assets/studio/properties/Set-Tag.png b/content/en-us/assets/studio/properties/Set-Tag.png
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8a8759a9ae10474ad5c9a275adfc116450f72dd1d7128da5c5457ebb71873f92
-size 3816
+oid sha256:2c44b840023b7d58d5bb32fa831a22f78a81188f00a64f6a3406037f91060c16
+size 4807
diff --git a/content/en-us/ip-licensing/creators.md b/content/en-us/ip-licensing/creators.md
@@ -74,7 +74,7 @@ We recommend that you include the following information in your pitch:
 Your pitch must **not** include any of the following:
 
 - Attempts to negotiate or discuss terms
-- Requests for financial of personal information
+- Requests for financial or personal information
 - Foul or harmful language
 - Legal or threatening language that could be considered harassing for a 13+ audience
 - Requests to connect with the IP holder outside of Roblox
diff --git a/content/en-us/studio/properties.md b/content/en-us/studio/properties.md
@@ -3,44 +3,21 @@ title: Properties window
 description: The Properties window lets you adjust properties of a selected object to change how it looks and behaves.
 ---
 
+import BetaAlert from '../includes/beta-features/beta-alert.md'
+
 The **Properties** window, accessible from Studio's **Window** menu or **Home** tab toolbar, allows you to adjust certain properties of a selected object to change how the object looks and behaves. Additionally, you can manage [tags](#instance-tags) and configure instance [attributes](#instance-attributes) at the bottom of the window.
 
 <img src="../assets/studio/general/Toolbar-Properties.png" width="800" alt="Properties highlighted in Studio's toolbar." />
 
-<img src="../assets/studio/properties/MeshPart-General.png" width="320" alt="General appearance properties for a MeshPart" />
-
-## Header bar
-
-When you select an object, the window's header bar changes to reflect both the class and name of the object.
-
-<Grid container spacing={3}>
-	<Grid item>
-	<figure>
-    <img src="../assets/studio/properties/Header-Example-A.png" width="320" />
-    <figcaption>A `Class.Model` named StoneColumn</figcaption>
-  </figure>
-	</Grid>
-	<Grid item>
-	<figure>
-    <img src="../assets/studio/properties/Header-Example-B.png" width="320" />
-    <figcaption>A `Class.Script` named CandleFlicker</figcaption>
-  </figure>
-	</Grid>
-</Grid>
-
-## Section organization
-
-The **Properties** window divides an object's properties into sections. For example, a `Class.MeshPart` includes sections like **Appearance** and **Transform** which respectively allow you to change its appearance and transform its `Class.BasePart.Size|Size`, `Class.BasePart.CFrame|CFrame`, and origin.
+When you select an object, the window's header bar changes to reflect the object's class and name, and its properties are divided into sections. For example, a `Class.MeshPart` includes sections like **Appearance** and **Transform** which respectively allow you to change its appearance and transform its `Class.BasePart.Size|Size`, `Class.BasePart.CFrame|CFrame`, and origin.
 
 <img src="../assets/studio/properties/Sections-Example.png" width="320" />
 
+<Alert severity="info">
 You can collapse or expand any section or subsection by clicking the small arrow to the left of its name. After you expand or collapse a section, it remains expanded or collapsed for other objects of the same class, as well as related objects that share the same property grouping.
+</Alert>
 
-<img src="../assets/studio/properties/Section-Expand-Collapse.png" width="320" />
-
-## Expand inputs
-
-Some properties are collapsed by default, but you can expand them by clicking the small arrow next to its name. For instance, `Class.BasePart|BaseParts` contain a **Position** property which represents an X, Y, Z coordinate in the 3D world. In Studio, these coordinates can be entered in two ways:
+Some properties are collapsed by default, but you can expand them by clicking the small arrow next to its name. For instance, `Class.BasePart|BaseParts` contain a `Class.BasePart.Position|Position` property which represents an **X**, **Y**, **Z** coordinate in the 3D world. In Studio, these coordinates can be entered in two ways:
 
 <GridContainer numColumns="2">
   <figure>
@@ -57,7 +34,7 @@ Some properties are collapsed by default, but you can expand them by clicking th
 After you expand or collapse a property, it remains expanded or collapsed for other objects of the same class, as well as related objects that share the same property.
 </Alert>
 
-## Filter properties
+## Property filter
 
 You can filter properties by typing a search query into the **Filter Properties** input near the top of the window. For example, filtering by the letters "velo" finds all properties containing them, such as **AssemblyLinear<u>Velo</u>city** and **AssemblyAngular<u>Velo</u>city**. Quickly access this input by pressing <kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>P</kbd> (Windows) or <kbd>⌘</kbd><kbd>Shift</kbd><kbd>P</kbd> (Mac).
 
@@ -127,7 +104,7 @@ You can store the following types/values in attributes:
 
 New attributes can be created and modified in Studio as follows:
 
-1. Select the instance, scroll to the bottom of the **Properties** window, and click the **+** button.
+1. Select the instance, scroll to the **Attributes** section, and click the **+** button.
 
    <img src="../assets/studio/properties/Add-Attribute-Button.png" width="320" />
 
@@ -136,6 +113,39 @@ New attributes can be created and modified in Studio as follows:
 
    <img src="../assets/studio/properties/Set-Attribute.png" width="320" />
 
-1. If necessary, you can **rename** or **delete** an attribute by clicking the gear icon.
+1. If necessary, you can rename or delete an attribute by clicking the gear icon.
 
    <img src="../assets/studio/properties/Rename-Delete-Attribute-Button.png" width="320" />
+
+## Configurable defaults
+
+<BetaAlert betaName="User Provided Default Instances" leadIn="This feature is currently in beta. Enable it through " leadOut="." components={props.components} />
+
+The **configurable defaults** feature allows you to save properties from a selected `Class.Instance` as the new default for that type, reset them as needed, and share them from a local file if desired. Use cases include:
+
+- A default `Class.MeshPart` instance where `Class.BasePart.Anchored|Anchored` is `true`, so that every new `Class.MeshPart` inserted into the 3D workspace is anchored.
+- A set of default [mechanical constraints](../physics/mechanical-constraints.md) with physical behaviors that match the type of mechanisms you're currently building, such as massive vehicles vs. smaller machines with less mass.
+- A set of default [light](../effects/light-sources.md) sources (`Class.PointLight`, `Class.SpotLight`, `Class.SurfaceLight`), each with `Class.Light.Brightness|Brightness` that suits the environment you're designing.
+
+To **set** a specific instance as the default:
+
+1. Select the instance in the 3D viewport or [Explorer](./explorer.md) hierarchy.
+2. From Studio's main **Edit** menu, select **Save&nbsp;as&nbsp;Default&nbsp;[Instance]**. A toast notification will indicate that the default has been updated, and newly inserted instances of that type will match the default properties.
+
+   <img src="../assets/studio/properties/Default-Properties-Toast.jpg" width="100%" />
+
+	 <Alert severity="info">
+	 Instance defaults are saved **locally** on each machine to a `DefaultInstances.rbxm` file, not to your Roblox or group account. The location of this directory can be changed in Studio's settings (<kbd>Alt</kbd><kbd>S</kbd> or <kbd>⌥</kbd><kbd>S</kbd>) under the **Studio** tab&nbsp;⟩ **Instance&nbsp;Defaults&nbsp;Dir**.
+	 </Alert>
+
+To **reset** a configurable default instance:
+
+1. Select any instance of that type in the 3D viewport or [Explorer](./explorer.md) hierarchy.
+2. From Studio's main **Edit** menu, select **Reset&nbsp;Default&nbsp;[Instance]**. Existing instances of that type will retain their properties, but newly inserted instances will use Studio's default properties.
+
+<Alert severity="warning">
+Note the following exceptions and behavioral rules to default instances:
+
+- The **positional** instance properties `Class.BasePart.Position`, `Class.BasePart.CFrame`, `Class.PVInstance.Origin`, and `Class.Model.WorldPivot` are **not** affected by default properties, but rather are overridden by Studio insertion rules and workflows. However, `Class.GuiObject.Position` and positional properties for `Class.Attachment|Attachments` (`Class.Attachment.Position|Position`, `Class.Attachment.WorldCFrame|WorldCFrame`, `Class.Attachment.WorldPosition|WorldPosition`) are stored/maintained in configured defaults of those instance types.
+- Studio's **Group as Model** (<kbd>Ctrl</kbd><kbd>G</kbd> or <kbd>⌘</kbd><kbd>G</kbd>) and **Group&nbsp;as&nbsp;Folder** (<kbd>Ctrl</kbd><kbd>Alt</kbd><kbd>G</kbd> or <kbd>⌘</kbd><kbd>⌥</kbd><kbd>G</kbd>) actions do **not** use the instance defaults for `Class.Model` or `Class.Folder`, respectively.
+</Alert>
