Hi Developers and Creators,
We are still hard at work improving Roblox Studio to make creation easier and to support your unique workflows. A few weeks ago, we updated the Studio Ribbon and overhauled docking to improve Studio configurability and responsiveness.
Today, we’re excited to invite you to join the new Studio icon beta. These redesigned icons unlock high DPI capabilities and take into account the community feedback we heard from the first release of the icons. We’ve improved the readability, usability, and accessibility by including more distinct colors and styles to make it easier to distinguish between them.
We also want to support individual UI preferences so we’re making it easier for you to set up your own customized icons. You can do so by following the instructions at the bottom of this announcement.
We’re excited to share the updated icon set with all of you and hope that you will find them to be more accessible and a better fit for your workflows (not to mention the high DPI capabilities that we know you all need)! Join our beta, where you can see the changes, engage with the new icons, and work together to make everyone’s Studio experience better!
To opt-in, make sure the “Enable DPI Aware Studio” feature is checked in the Beta Features dialog box (File->Beta Features).
We will keep iterating and improving your experience over time so please keep the feedback coming!
Note: If you updated Studio between 12:00 - 2:00 PST on Oct 26, you may encounter a bug with missing AssetManager/TerrainEditor icons. This can be corrected by reinstalling Studio, and will have no effect on Studio if the BetaFeature is disabled.
How To Use Custom Icons in Studio
This guide will allow you to override the insertable object icons (any object icon you see in the explorer). The icon system is following the detailed specs documented here.
-
Create a folder on your computer named RobloxCustom
-
Populate this folder with pngs of all the icons you want to override. All explorer icons are 16x16 pixels, however since Studio is now DPI-aware, you may wish to provide additional sizes for your icon pack. We will select the icons you provide closest in size to the ones requested.
Example of windows scalings and desired explorer icon sizes:- 100% scaling : 16 x 16 px
- 150% scaling : 24 x 24 px
- 200% scaling: 32 x 32 px
-
All Overridden icons should have the exact same name, as how the object appears in the explorer (e.g. “Workspace.png”, “Camera.png”)
-
For each size of icon provided, put all icons of that size in its own subfolder of RobloxCustom. These subfolders should be named for the scaling size (e.g. “scaled150”, “scaled200”)
-
Inside the RobloxCustom folder create a file named
index.theme
. This file is an ini file in line with specifications linked above. It MUST INCLUDE theInherits=Roblox
line, or else we will not render any icons except your custom icons. It also has a name and comment which can be anything.
And then the [name] of each subfolder in RobloxCustom and the size and scale of icons found in that folder (you can usescale=1
for all your icons subfolders for now)
It should look something like this:
[Icon Theme]
Name=CoolerIcons
Comment=My custom icon pack
Inherits=Roblox
[standard]
Size=16
scale=1
[scaled150]
Size=24
scale=1
And would have a corresponding directory structure looking like:
-RobloxCustom
-standard
-Workspace.png
-Camera.png
-Part.png
-scaled150
-Workspace.png
-Camera.png
-Part.png
- In Studio Settings set
CustomIconDir
to the PARENT FOLDER of RobloxCustom. And then your icons should be visible in Studio!
Note that Certain Explorer icons also are used in the ribbon. For example, if you override the RigidConstraintIcon, this also appears in the ribbon Constraints menu as a base 32x32 icon. Your new icon will also be used here, and may be blurry if you do not provide appropriate sizes.
Expand for Custom Icon FAQ
Can I override a partial set of Explorer icons?
- Yes. We will fall back to default icons if a custom one is not found.
Can I have themes for light and dark in one icon pack?
- Not yet, but we are exploring how to enable this.
Can I override icons outside of the insertable object icons?
- The ribbon icons can also be overridden in the same manner, but we have not yet standardized naming conventions for the ribbon. These will be provided at a later date.
Will Roblox delete my RobloxCustom directory whenever I update Studio?
- No, as long as you do not store it in the Roblox executable directory