Properties window

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 and configure instance attributes at the bottom of the window.

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 MeshPart includes sections like Appearance and Transform which respectively allow you to change its appearance and transform its Size, CFrame, and origin.

Some properties are collapsed by default, but you can expand them by clicking the small arrow next to its name. For instance, 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:

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 AssemblyLinearVelocity and AssemblyAngularVelocity. Quickly access this input by pressing CtrlShiftP (Windows) or ⌘ShiftP (Mac).

Instance tags

The Tags section allows you to apply specific tags for use with CollectionService. Tags are sets of strings applied to instances that replicate from the server to the client. They are also serialized when places are saved.

To add tags to an instance through the Properties window:

1. Select the instance, scroll to the Tags section, and click the + button.

   

2. In the popup window, enter a new tag name or select a tag you've already created for any other instance from the list below the input field. The tag will appear within the Tags section.

   

3. If necessary, you can remove an existing tag by clicking the × icon.

   

Instance attributes

Attributes allow you to customize instances with your own data. They are similar to built-in object properties, but you can create and modify your own attributes for any instance. Key features include:

• Attributes can be created, edited, and deleted directly within Studio or through scripting (see properties and attributes for script commands to create, set, get, and delete attributes).
• Attributes and their values are saved with your place and assets.
• Value changes can be viewed in real time and are replicated so that clients can access them immediately.

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 Attributes section, and click the + button.

   

2. In the popup window, enter the attribute Name, select its Type, and click Save.

3. The new attribute will appear with a default value that you can change just like any other property.

   

4. If necessary, you can rename or delete an attribute by clicking the gear icon.

   

Configurable defaults

The configurable defaults feature allows you to save properties from a selected 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 MeshPart instance where Anchored is true, so that every new MeshPart inserted into the 3D workspace is anchored.
• A set of default mechanical constraints 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 sources (PointLight, SpotLight, SurfaceLight), each with 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 hierarchy.

2. From Studio's main Edit menu, select Save as Default [Instance]. A toast notification will indicate that the default has been updated, and newly inserted instances of that type will match the default properties.

   

   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 (AltS or ⌥S) under the Studio tab ⟩ Instance Defaults Dir.

To reset a configurable default instance:

1. Select any instance of that type in the 3D viewport or Explorer hierarchy.
2. From Studio's main Edit menu, select Reset Default [Instance]. Existing instances of that type will retain their properties, but newly inserted instances will use Studio's default properties.