Once data is successfully synchronized in the Admin Portal, you can configure it to optimize visuals in vSite AR and vSite Web.

To view or edit an object layer’s configuration, select it from the Data Sources list.

General

Coordinate System (EPSG)

Where applicable, georeferenced data will require identification of the EPSG code used in the original source file at time of development. When the matching EPSG code is entered into this field in the Admin Portal, the model will appear in its matching geographic location.

Vertical Datum

Configuring the vertical datum field in the vSite Admin Portal will apply the correct geoid definition to calculate the elevation of objects that will be displayed in vSite AR and vSite Web.

The vertical datum settings must match the datum used in the original source file or dataset.

Enable Model Interactions Switch

This field enables the physics engine within the model and its categories so users can interact with its data. When OFF, the selected model cannot be interacted with (e.g., you wouldn't be able to click on objects within the model or see distance and elevation to a selected point) and can only be viewed in AR or vSite Web. This will relieve processing power for your device if it slows down while operating the mobile app.

Enable Double-Sided Surfaces Switch

This feature is primarily used for datasets with double-sided renderings, such as cut-and-fill profiles. Such surfaces can be viewed from both sides of the surface.

It is advised to disable it unless absolutely necessary. Double-sided surfaces will double the processing requirements on your mobile or holographic device, which may impact performance. To read more, click here.

Layer Group

Layer Groups are the categories that can be customized for viewing data in vSite AR and vSite Web.

Users can assign a whole dataset to a single layer or breakdown a structure of utilities into multiple layers that can be toggled at any time, controlling the visuals in augmented reality or in the web-based digital twin.

Object Type

The object type field will determine if the data going into vSite AR and vSite Web is either a Line, Point, Area, or 3D Object.

Note: It is highly advised to not change this field. Changing the object type may cause potential risks to how the datasource is processed and therefore any changes will have to be made at the source file.

Header

Specifies the header displayed when viewing an object in the 3D environment. By default, this is the object ID.

Color

The color selector in the configuration screen is meant to help users customize colors of their 3D models in both vSite AR and vSite Web.

When opened, users can select from a spectrum of different colors, choose the opacity level, and can enter manual Hex codes to bring up a specific color. There are also a total of 30 preset colors to choose from.

Recommendation: Apply transparency (20–30% opacity) for large objects (e.g., Areas) to improve visibility.

Object Configuration

Object Subtype

This drop-down field defines how Line and Point objects will appear in vSite AR and vSite Web. Line has two options - Line (to display flat lines) or Pipe (to display cylindrical pipe-like objects). Point objects has multiple predefined objects, including geometric shapes and different common manhole and inlet types.

Default Depth/Elevation

This setting allows you to set a default depth or altitude to an object layer. Zero is considered to be ground level, with positive numbers being above ground (altitude), and negative numbers being underground (depth).

You can also specify the unit of measurement from the adjacent drop-down menu.

Default Height

This field allows you to set the length or height for the layer element (Areas, Lines, Points and 3D Models). If not defined, the default value of 15cm will be applied.

To make an object (like a cone or prism) flip upside down, fill this field with a negative number and the height measurement will start from the top and expand downwards.

Default Width

This field allows you to set the width for the layer element (Areas, Lines, Points and 3D Models). Leaving this field blank will use the default width of 10cm.

Default Diameter

The Default Diameter field allows you to set the width for Pipe elements and 3D markers of a specific layer within your datasource. Leaving this field blank will use the default characteristics from the source file.

Depth/Elevation Field

If your data source includes depth/altitude values, you can map them to vSite:

Review the data and determine the field containing depth/elevation values.
Select the appropriate field in the Depth/Altitude Field drop-down.
Choose the correct unit of measurement.

Height Field

This field can be used to extract any layer's height dimensions when applicable. A layer's Sample Data table can determine if the height measurements are present. When the data heading is selected in the drop-down, those characteristics will be used when projecting models in vSite and vSite AR.

Width Field

This field can be used to extract any width dimensions when applicable. A layer's Sample Data table can determine if the width measurements are present. When the data heading is selected in the drop-down, those characteristics will be used when projecting models in vSite and vSite AR.

Diameter Field

This field can be used to extract any width dimensions for pipe layers. A layer's Sample Data table can determine if the diameters are present. When the data heading is selected in the drop-down, those dimensions will be used when projecting models in vSite and vSite AR.

UoM (Unit of Measurement)

UoM stands for "unit of measure" and can be modified at the Configuration tab within the layer of a datasource. It is recommended to match the UoM that was used in the original source file, otherwise the option selected in the Admin Portal will reconfigure the size in either AR or vSite Web.

Possible UoMs: millimetres (mm), centimetres (cm), meters (m), inches (in), feet (ft), and survey feet (sft).

Additional Details

Subtype Field

This drop-down field, when a heading is selected, will break down a layer into sublayers based on the unique values in the field selected as a Subtype.

Subtypes can be individually configured to provide greater visual variety of objects in vSite AR and vSite Web.

Label Type

This drop-down will add a text label to assets in vSite AR. There are several label types to refine the visuals. Select between Risers or Text Only Labels, and when applicable change the shape to either a triangle, pin, or point.

Infocard Image

This field will change the image within the layers Infocard. If left alone, the infocard will use a default vSite image based on the object type and layer color.

Elevation Type (Additional Details)

The Elevation Type field in the vSite Admin Portal will tell the system how to position digital elements along the z-axis. This field can override elevation settings from the source file.

The options available are; Default, Parent Node Setting, Surface Offset, and Ignore Z-Value. To learn more about each of these fields, click here.

External ID Field

The External ID field allows you to cross-reference your vSite data to an external database by assigning an external ID to the object in this field. View the Sample Data table of the layer to view the options for this ID.

Exclude from Processing

When this switch is enabled for a selected layer, that layer (and all its objects) will be excluded from the model or dataset. All other layers with this toggle switched off will be processed.

Anytime the switch is toggled you will need to reprocess your data for changes to take effect.

Click here to access an article with links to configuration steps by data type.

Have Questions? Feel free to Submit A Request to speak with a member of the vGIS Support Team.

Reviewed: 2025-08-26