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 older version of V-Ray to V-Ray 3.6, visit the Migrating from Previous Versions page for V-Ray 3.6 for SketchUp.


V-Ray for SketchUp 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 SketchUp 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 SketchUp (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 SketchUp with V-Ray Next.  When the scene is saved, the updates are saved with it.


Material Structure

The internal material structure used in V-Ray for SketchUp 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 Project Material ID Colors Tool

Found in Extensions > V-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.

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.


Triplanar texture

Triplanar texture is now affected by SketchUp material size.
In previous V-Ray versions, it was projected at a UV size of 1x1 inch and multiplied by its Size parameter (default value 10). To restore the same way it looked in version 3.6, adjust either the SketchUp material size to 1 by 1 inch or decrease the Triplanar's Size value accordingly.


Lights viewport widgets

 The viewport widgets for all V-Ray Lights and the V-Ray Infinite Plane are updated. They now come with additional lines to help with snapping, positioning or rotating. To switch back from their new look to the old solid display a new toolbar button is implemented - The Enable Solid Widgets button.

Lights Intensity Tool 

The Light Intensity tool is no longer available. Its functionality is now part of the new V-Ray Scene Interaction Tool. 

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.


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.