This page provides information on how the latest version of V-Ray handles scenes saved with previous versions of V-Ray.



V-Ray Next adds a number of rendering optimization features. However, for compatibility reasons, some features and workflows have been adjusted and are discussed in detail below.

If you are migrating from an older version of V-Ray to V-Ray 3.6, visit the Migrating from Previous Versions page for V-Ray 3.6 for Rhino.


V-Ray for Rhino is not forward-compatible, meaning projects done with V-Ray Next are not guaranteed to work with V-Ray 3.6 or older versions. If a project is opened using an older V-Ray version than the one it was created with a prompt message will offer wiping all V-Ray data to ensure file stability.

V-Ray Next for Rhino licenses also work with V-Ray 3.6, allowing anyone who purchases an upgrade to complete unfinished projects using V-Ray 3.6 if needed.

Opening a Scene

When a scene saved with V-Ray version 3.6 or older is loaded in Rhino (using V-Ray Next), an upgrade script will go through all the scene assets and features to account for incompatibilities.  All lights, materials, and special objects will be upgraded from groups to a new component definition system. This upgrade can take some time, but only happens the first time the scene is opened in Rhino with V-Ray Next.  When the scene is saved, the updates are saved with it.


When opening V-Ray Next for the very first time in Rhino if the scene assets are missing, close Rhino. Open a new scene, set current renderer to V-Ray and all assets will load correctly from then on.


V-Ray 3 scenes with custom aspect ratio and safe frames enabled may have their width or height size reverted to default values (640/480). This may also cause incorrect output if submitted for Cloud rendering. To account for this inconsistency, it is best to manually set the output size of affected scenes after opening them in V-Ray Next.


Material Structure

The internal material structure used in V-Ray for Rhino is updated and modernized. This in turn leads to the material asset UI being updated.

Reflection, Refraction and Diffuse material layers' Transparency parameters are switched to Opacity controls for consistency. Any old materials containing such layers will be migrated automatically to the new internal structure.

Material Environment Overrides

The material Environment Overrides rollout has been removed. This functionality has been shifted to the Override material which now contains an Environment map slot.

Stochastic Flakes material

The Stochastic Flakes material can no longer be created from the Asset Editor’s Create menu. Create a Generic material, remove its default V-Ray BRDF layer and add a Stochastic Flakes layer to use it.

VRScene files

Due to the deprecation of the MtlASGVIS plugin VRScene files exported with V-Ray 3.6 or earlier are missing material options such as displacement/bump.

Randomize Material ID Colors Tool

Found in Rhino menuV-Ray > Tools, this tool allows you to assign a random color ID to your materials. This provides a workaround for materials from v2.0 scenes which all have black color IDs.
Note that it will not affect Material ID numbers, which by default are set to 0.

Reflection/Refraction Max Depth

Negative material reflection and refraction trace depth values are no longer permitted. Any material parameters with such values are reset to the default value of 5.

Preset Library Assets


The Preset Material Library location in V-Ray Next is changed, which may result in UI markers about missing files of associated Bitmap textures. Despite these warnings, V-Ray automatically resolves each incorrect library file path to make sure the render output remains the same.



The V-Ray Clipper's Include/Exclude list is no longer available. Including or excluding scene objects is now managed in Rhino’s V-Ray properties panel. Pick objects to be added to the list by selecting them in the viewport or using one of the native Rhino selection functions like ‘By Layer’, ‘By Color’, ‘By Name’ etc. Use the Select Objects function to see what is already in the list even for Clippers migrated from V-Ray 3.


Fur strands in the viewport are now positioned on faces instead of vertices. This change only affects the preview of VRayFur. The actual render output remains unchanged.

Object visibility controls

The "Skip Rendering" and "Visible" object properties are no longer available. The new "Ignore in VP State" option for Fur and Clippers allows the same visibility control between the Rhino viewport and V-Ray render output.

Render Elements

Render elements are now treated as assets - they can be created or deleted in the Assets list.

Glossiness Channels

The Reflection Glossiness, Refraction Glossiness and Reflection Highlight Glossiness render elements can no longer be created. V-Ray 3 scenes with these channels will still render them correctly.


The Denoiser is now treated as a render setting and not a render element. Find its options in the advanced render settings panel in the Denoiser rollout. The ‘Effects Update Frequency’ control is moved to the Denoiser section for convenience - now called Update Frequency. It still affects both the Denoiser and the VFB Lens Effect updates


Advanced Camera Parameters rollout is introduced to the advanced settings panel. All the physical camera controls like F-Number, Shutter Speed and ISO (previously listed in the Camera rollout ) are now located there.


Scenes from v3.6 opened with V-Ray Next may contain an extra Environment texture in the Textures category. It is not plugged in any map slot. It can be safely removed or purged.


V-Ray Render

Newly created V-Ray Render components have their V-Ray Geometry input automatically flattened. 

V-Ray Render in Project

The V-Ray Render in Project component is now always disabled when loaded from an existing project and will need to be manually enabled in order to function.


Quality Setup 

As good practice, we recommend a reset of all the render settings (‘Revert to Default Render Settings’) when loading a V-Ray 2 scene. Starting fresh is extremely easy thanks to the Quality slider and the new approach. Keep in mind that, being part of the render settings, any Environment textures will also be disconnected and colors reset. 

Loading ‘.vropt’ or ‘.visopt’ files created in previous V-Ray versions is not recommended. Some outdated parameters may cause unexpected results. Using the new streamlined quality presets, and then fine-tuning the settings before saving them in a new ‘.vropt’ file is the recommended approach.