---
title: "VRaySwitchMtl"
canonical: "https://documentation.chaos.com/space/VMAYA/111740021/VRaySwitchMtl"
format: markdown
---
This page includes details on the Switch utility material in V-Ray.


## **Overview**

---


<details>
<summary>UI Path: ||Right-click on the geometry|| > Assign New Material...</summary>

||Right-click on the geometry|| **>** Assign New Material... **> VRay** section **> VRay Switch Mtl**


![image](media://8219d8df-aac1-4e66-893f-21a60c9f7f5c)


||V-Ray Shelf|| **> **Right-click to** Create V-Ray Materials **button **> VRay Switch Mtl**


![maya2025_72010_Shelf_VRayMtls.png](media://f2849261-442e-47aa-8ad2-946bc1c49de0)



||Hypershade||** > Window** tab** >** **Create... > VRay **section **> VRay Switch Mtl**


![image](media://d30b8cd6-b86e-40e7-ae61-0231bb4b0cb5)
</details>


## **Parameters**

---


Values are defined by the assigned **Switch** texture or the Switch value when no texture is specified. When no material is linked to the current value, the geometry will not have valid shading and will not be visible in the render.

> Macro (ui-text-box)
> 
> VRaySwitchMtl doesn't have a default material. If the switch value points to an empty (undefined) material slot, the resulting shading will use the first valid material (the one with the lowest switch value) specified in the VRaySwitchMtl.
> 
> If the switch value is out of range, V-Ray proceeds to the next available material, skipping empty slots and looping back to the beginning.

> Macro (ui-text-box)
> 
> VRaySwitchMtl is very powerful when used with the VRayUserScalar texture, which enables switching sub-materials to be applied based on geometry specifics, not just a single animatable value.


## **Hardware shading**

---