Naming rules

Layer Naming
Prefixes & Syntax

The complete naming reference users need to structure a PSD correctly.

Plugin: UI Widget BuilderTarget: UE 5.6 / 5.7 / 5.8Workflow: PSD → layout.json + Textures → UMG Widget BlueprintAuthor: Ali Shantia

Core widget prefixes

Layer and group names control how the importer creates UMG widgets.

PrefixUnreal widgetUse
CAN_CanvasPanel / root screenMain screen/page container. Example: CAN_MainMenu.
BTN_ButtonInteractive button group with state art.
TXT_ / LABEL_TextBlockReal Photoshop text layer. Exports content, color, alignment, font data, and direction.
IMG_ / BG_ / ICO_ImageGeneral visual texture.
PNL_Box / panel imagePanel-style brush, useful for 9-slice backgrounds.
SLD_SliderNeeds track and thumb parts.
RSLD_RadialSliderRadial slider with radial thumb part.
CHK_ / TGL_CheckBox / ToggleButtonOptional box, checkmark, and label parts.
CHKG_Checkbox group metadataExclusive checkbox group container. Needs at least two CHK_/TGL_ children. The first child imports checked by default; group text labels are non-hit-testable.
TXI_ / TXIM_EditableTextPlain editable text input.
ETB_ / ETBM_ / ETM_EditableTextBoxEditable text input with box chrome. Add BG_ for the box background and TXT_ for placeholder/font data.
CMB_ComboBoxStringDropdown string selector.
OPT_Combo optionOption entries inside a combo group.
SPN_SpinBoxNumeric input.
PGB_ProgressBarProgress background and fill art.

Layout containers

PrefixUnreal widgetUse
HBX_ / VBX_HorizontalBox / VerticalBoxOrdered children in a row or column.
WBX_WrapBoxChildren wrap within folder width.
GRD_ / GDP_ / GPN_GridPanelGrid slots computed from child positions.
UGP_UniformGridPanelUniform cells based on largest child.
SCB_ / SCR_ScrollBoxVertical/horizontal scroll area.
WSW_ / WIS_WidgetSwitcherTabbed or page-switch UI.
OVL_OverlayStacked children.
SFZ_ / SAFE_SafeZoneSafe area wrapper.
SCX_ / SCL_ / SBX_ScaleBoxScale wrapper.
SZB_ / SIZE_SizeBoxFixed size wrapper.
BDR_BorderSingle-child border wrapper.
SPS_SpacerFixed empty space.

Parts used inside widget groups

Part prefixTypical parentRole
IMG_NormalBTN_Button normal state.
IMG_HoverBTN_Button hover state.
IMG_PressedBTN_Button pressed state.
BAR_SLD_, RSLD_, SCB_Track or size reference.
THM_SLD_Slider thumb.
RTHM_RSLD_Radial slider thumb.
BOX_CHK_Unchecked checkbox art.
CHKMARK_CHK_Checked checkbox art.
FILL_PGB_Progress fill art.
ARW_CMB_Dropdown arrow art.

Numbers and modifiers in names

SyntaxExampleMeaning
Spacer sizeSPS_60,20Spacer 60 wide, 20 high.
Grid sizeGRD_3x23 columns, 2 rows.
Scroll orientationSCB_H_ItemsHorizontal ScrollBox.
Fixed scroll viewportSCB_S_ItemsUse folder bounds as visible viewport.
Button rotationBTN_Play ROT_-12Applies rotation to the button widget.
Shared textureIMG_Icon_IDN_AReuses texture key A.