How to Edit your VR Space in Edit Mode

Giving customers the ability to experience Matterport in VR means providing a more in-depth, immersive experience to users. This article will teach you how to edit and share a Matterport VR experience using the Edit Mode. Before you begin, make sure that your VR Space is public and VR-enabled.


I. Review the VR Experience 

Open your Matterport VR Space on your Cardboard or Gear VR, then look for the following:

  1. Too many blue circlesScreen_Shot_2019-07-16_at_2.00.48_PM.png
    • If you see an excess of blue circles, this means the view has become cluttered which will make navigation confusing and difficult.       
  2. Very small blue circles
    • Small blue circles indicate that the scans are too far away - this makes selecting the points of interest difficult.
  3. Inappropriate visuals
    • There may be parts of your scan (like a bathroom or broom closet) that you want to make invisible in VR.
  4. Inaccessible visuals
    • If you're in a museum, for example, you may have taken a scan in front of a painting, but the VR path may have hidden that scan.

We do not recommend editing Spaces that have been converted with CustomVR.

II. Hide VR Scans 

  1. Go to 
  2. Switch to the Floorplan View. 
  3. Click the "Edit VR" button in the toolbar. Screen_Shot_2019-07-09_at_1.56.28_PM.png
  4. Your scanned positions will be visually represented by blue and white circles.
    • Blue circles are visible in VR. 
    • Blue circles are visible in Showcase mode. 
    • White circles are hidden in VR. 
    • White circles are visible in Showcase mode. 
    • If no scan positions are visible, they have been disabled for Showcase - click the "Edit VR" button to exit the VR editor. Then enable your scan positions in 3D Showcase.
  5. Find VR navigation lines.Screen_Shot_2019-07-09_at_1.59.08_PM.png
    • When scattered throughout a Space, blue circles form a "constellation" - that is, a visible path between circles that represents your movement in VR.
    • Navigating between positions in VR Space requires a clear line-of-sight between your current position, and the next position. Your VR navigation lines represent the line-of-sight between two circles in the path.
  6. Disable (hide) a VR spot.Screen_Shot_2019-07-09_at_2.08.09_PM.png
    • This can be done by clicking the "VR Path" icon once to disable, then hovering over a blue circle and clicking "Hide" - this will turn blue circles white.
  7. Enable (show) a VR spot.Screen_Shot_2019-07-09_at_2.09.15_PM.png
    • This can be done by hovering over a white circle and clicking "Show" - this will turn white circles blue.

III. Optimal VR Experience Guidelines 

  1. Put a blue circle in every room and space you want users to see.
  2. Make sure blue circles aren't too far apart.
    • As stated earlier, you should be able to see the next point in your path in VR. This makes for natural transitions and avoids disorienting the user.
  3. Do not place blue circles next to walls. 
    • You want to avoid doing this because walls make it difficult to place the next point in your VR path. 

IV. Find Isolated Scans 

If you disable a scan that exists in the middle of a constellation, you may isolate scan paths, turning a single constellation into two or more. This is doesn't create a positive user experience, as users will not be able to explore the entire VR Space in one seamless walkthrough.lines.png

Pictured above: Isolated, unconnected lines. The only VR path that will be taken is in the constellation with the 3D Showcase Starting Position - the remaining paths will not work in VR unless connected as a single constellation. 

You can find isolated scans by locating isolated, unconnected lines in your Floorplan. Follow the steps below to fix this issue.

  1. Enable more scan positions.
    • You can create additional scan positions in an effort to link the existing VR spots into a single constellation.

V. Set your VR Start Position 

By default, the starting position in VR will be the same as your starting position in 3D Showcase mode - learn how to set your Start Position in Showcase.

There are, however, two reasons why your Start Position in 3D Showcase mode differs from your VR Start Position:

  1. Your Start Position in 3D Showcase mode is not visible in VR.
    • 360º Views, Dollhouse Views, and Floorplan Views do not show up in VR. 
  2. The scan is marked visible in 3D Showcase but disabled for VR (white circle). 
    • If this happens, Matterport will automatically choose a random spot in the constellation as the VR Start Position - this is typically acceptable for most users, though you can change your Starting Position in 3D Showcase for more precise control.

VI. Publish your VR Space 

Click the "Publish" button in the top-right corner of the Editor window to apply changes. 

VII. Review your Space in VR 

  1. Open the VR Space in Cardboard or Gear VR. 
  2. Navigate to the "Shared With Me" folder. VR1.png
  3. Open the VR Space you just edited. VR2.png
  4. Select the "Update" icon to download the changes you've just made. VR3.png
  5. Explore the VR experience. 
    • Make sure you addressed everything correctly, and that the VR walkthrough is easy to navigate. 
  6. If necessary, return to Edit Mode and make additional changes. 


Have more questions? Submit a request