Learn how the latest version of V-Ray for SketchUp handles scenes saved in earlier versions.
Overview
V-Ray 7 adds rendering optimisations. Some features and workflows have changed for compatibility, as explained below.
V-Ray for SketchUp is not forward-compatible. Projects created in V-Ray 6 are not guaranteed to work in earlier versions. If you open a project in an older V-Ray version than the one used to create it, a prompt offers to delete all V-Ray data to keep the file stable.
GPU
From V-Ray 7, a GPU tab replaces CUDA and RTX in the render engine settings. V-Ray GPU uses NVIDIA CUDA or RTX devices for raytracing calculations. You can select the GPU engine in the V-Ray GPU rollout.
Lights
The Portal Light option in the V-Ray Rectangle light is now a legacy option and is hidden from the interface. Adaptive sampling for dome lights and environments removes the need for Skylight portals.
Rectangle lights saved in earlier V-Ray versions with Portal Light enabled still have the option available. For best performance, consider disabling it and using Adaptive Dome Light instead.
Materials
PBR layers automatically convert to regular VRayMtl layers. This gives PBR materials access to all other parameters, including refraction, anisotropy, sheen and coat. The conversion also lets you import PBR materials from other host apps.
The Reflection rollout now includes Surface Control for metalness control. It switches from Glossiness to Roughness and affects Coat, Reflection and Sheen.
VRayMtl now has built-in Bump parameters. You can use these to set up linear shaders that render more efficiently and follow the workflow used in other host apps, such as 3ds Max and Maya. Materials that previously used the Bump attribute now use the built-in Bump.
Preset Material Library materials that previously used a Reflection Coat layer now use the built-in Coat. Previously, you created a base material and a separate Coat material, then combined them with a Blend shader. The new Coat layer is easier to set up and faster to render. Use it for reflective coatings, such as varnished wood floors or coated plastics. It also improves compatibility with cloud rendering, vrscene files and V-Ray Standalone.
Preset Material Library fabric materials that previously used a Diffuse Coat layer now use the built-in Sheen. Use Sheen for soft fabrics such as velvet, satin and silk. Built-in Sheen works directly with cloud rendering and improves compatibility with vrscene files and V-Ray Standalone.
The Toon material workflow from V-Ray Next is deprecated. Its replacement combines a global volumetric Toon with overrides for individual materials. This lets you set up a global effect faster.
The new Contour material attribute replaces the old Toon material, which is no longer supported in V-Ray 5.
Toon materials from earlier V-Ray versions automatically migrate to Toon Override materials. A Toon Override material is a Generic material with Contour enabled and no base.
The VRayMtl layer's Highlight Glossiness parameter is deprecated because it adds complexity and reduces material accuracy. Highlight Glossiness migrates from earlier versions. If it is disabled, its row is hidden and its value is set to 1.
Glossy Fresnel is hidden from the interface and enabled by default, including in older scenes. This represents physical materials more accurately.
A new Displacement object modifier replaces the deprecated Displacement material attribute. The displacement effect no longer appears in the Preview Swatch. The old attribute only worked when the material was the top-most shader applied to the geometry. You can apply the new modifier directly to geometry, regardless of its material. Multiple objects can therefore share the same displacement while using different materials.
The legacy Subsurface Scattering material has been removed. Materials created in earlier versions migrate to Raytraced by default because this method is physically accurate and produces the best results.
Materials with Normal opacity mode now use Stochastic opacity mode. Stochastic is the default and replaces Normal in older scenes. It gives the same results faster. If the opacity map contains only pure white and pure black, Clip mode calculates faster and gives better, more accurate results.
From V-Ray 6, the Fresnel formula is calculated more precisely. Some materials, mainly metals, may render slightly differently because their reflections are more physically accurate.
From V-Ray 6, the V-Ray Preset Material Library is part of the Chaos Cosmos Browser. Materials downloaded in earlier V-Ray versions remain unchanged. You can still load them as a custom folder.
From V-Ray 7, the Binding section in materials is renamed Viewport Display. The Texture helper has been removed. You can replace it with a custom texture.
Enscape compatibility
You can now render scenes created in Enscape using V-Ray. V-Ray automatically handles the materials and Enscape assets when you move your scene across. See Enscape Compatibility for details.
Special objects
From V-Ray 7, the new Remove from Selection function removes the Special object applied to another object.
Settings
Settings now includes a Contours rollout with a toggle to enable or disable global Contours.
Render elements
The new Contours Render Element stores a mask for global contours and individual material contours. You can use this mask for compositing. Contours appear only in a Contours render element, not in the RGB/Beauty image.
Textures
Double-sided mode is hidden from the Texture Placement parameters. You control it by assigning materials to individual faces. SketchUp now handles the option entirely for more consistent results between the Viewport and V-Ray.
V-Ray Frame Buffer
You cannot load Color Corrections saved as .vccglb files in V-Ray Next into V-Ray 5.
Migration from previous versions
V-Ray 6 for SketchUp licences also work with V-Ray 5. If you purchase an upgrade, you can finish existing projects in V-Ray 5 if needed.
V-Ray cannot read materials or other V-Ray data saved in versions older than v2.0.
To migrate an outdated scene, use a 2-step migration: first to V-Ray 3.6, then to V-Ray 5.
Visit the Chaos download portal, enable the Show older versions checkbox, then download V-Ray 3.6.
Uninstall your current version of V-Ray for SketchUp. Install v 3.6 instead. Open your outdated project. Inspect the scene materials in the V-Ray Asset Editor. Save the project to trigger automatic V-Ray data migration. Repeat these steps for V-Ray 5.
V-Ray 5 builds require the appropriate License Server. See Installing the License Server for details.
V-Ray 6 is the latest version that supports importing V-Ray 2 models, components and materials.
Scatter Viewer in previous SketchUp versions
This shows the Scatter Viewer in SketchUp 2022 and earlier versions. For versions 2023 and later, see Scatter Viewport Preview Workflow.
UI paths
||V-Ray Objects Toolbar|| > Scatter Viewer

SketchUp Menus Ribbon
||Extensions|| > V-Ray > Objects > Scatter Viewer
Workflow
In SketchUp versions earlier than 2023, open the Scatter Viewer through the V-Ray Toolbar or V-Ray Menu.
Add a Scatter Guest from the Asset Editor, or drag a preselected object from the viewport onto the Scatter Host object. Scatter Viewer must be active to add a Guest by dragging it onto the Host object. If you add a Guest this way, you can remove it using the drag + shift function.

Example of adding Guest objects to the Host object