URL Options Reference

General

asset_qualitynumber

1

Sets the quality level if it hasn't already been set with the quality picker.

Options:

• 0 - Standard
• 1 - Sharp
• 2 - Excellent
• 3 - Legendary
• -3 - Thumbnail
• -2 - Efficient
• -1 - Eco

autostartboolean

false

Enables autostart functionality. The viewer loads immediately when the page is ready.

autostart_systemcheckboolean

false

Enables automatic system check on page load.

enginestring

webgl

Sets the rendering engine type. Options: 'webgl', 'webgpu'.

Options:

• webgl - WebGL rendering engine
• webgpu - WebGPU rendering engine

fallback_langstring

de

Sets the fallback language for UI elements and text when the browser locale is not supported. Options: 'de' (German), 'en' (English), 'it' (Italian), etc.

inactivity_timeoutboolean

true

Enables automatic session timeout. User session ends after 2 hours of inactivity.

langstring

Sets the language for UI elements and text, overriding the browser language. Options: 'de' (German), 'en' (English), 'it' (Italian), etc.

preloadboolean

true

Enables preloading of all resources (textures) before the scene is displayed.

render_backgroundboolean

false

Enables background rendering of the scene. Has impact on performance.

start_birdseyenumber

0

Birdseye camera mode behavior. 0 = disabled, 1 = selectable in camera type selector, 2 = forced on start.

Options:

• 0 - Disabled
• 1 - Selectable in camera type selector
• 2 - Forced on start

start_thirdpersonboolean

false

Enables third-person camera mode on start. When disabled, forces first-person camera mode.

staticboolean

false

Disables loading of all dynamic items. Intended for GLB export only.

viewer_passwordstring

Sets the viewer password to unlock the viewer automatically.

Camera

camera_capsule_radiusnumber

0.4

Sets the camera collision capsule radius (world units).

camera_clipping_autoboolean

true

Enables automatic scaling of camera clipping planes (minZ and maxZ).

camera_clipping_maxnumber

200

Maximum camera clipping distance (far clipping plane, world units).

camera_clipping_minnumber

0.1

Minimum camera clipping distance (near clipping plane, world units).

camera_constraint_pitch_downnumber

-90

Sets the camera pitch down rotation limit (degrees). Range: -90 to 90.

camera_constraint_pitch_upnumber

90

Sets the camera pitch up rotation limit (degrees). Range: -90 to 90.

camera_constraint_yaw_leftnumber

0

Sets the camera yaw left rotation limit (degrees). Range: -180 to 180.

camera_constraint_yaw_rightnumber

0

Sets the camera yaw right rotation limit (degrees). Range: -180 to 180.

camera_fovnumber

45

Sets the field of view for the active camera (degrees).

camera_modestring

default

Sets the camera input mode. Options: 'default', 'inverse', 'keywalk'.

Options:

• default - Default camera controls
• inverse - Inverted camera controls
• keywalk - Keyboard walk mode

camera_positionstring

Sets the initial camera position. Format: 'alpha,beta' for birdseye or 'x,y,z' for walk mode.

camera_position_offsetnumber

0.5

Random offset applied to the camera position (world units).

camera_rotationstring

Sets the initial camera rotation for walk mode.

camera_speednumber

3

Sets the walk camera movement speed (world units/s).

camera_targetstring

Sets the initial camera target. Format: 'x,y,z' coordinates.

camera_teleportboolean

true

Enables teleport movement with right-click.

camera_walkboolean

true

Enables walk controls (WASD keys and right-click movement).

camera_zoom_autoboolean

true

Enables automatic scaling of camera zoom limits (camera_zoom_max and camera_zoom_min).

camera_zoom_maxnumber

200

Maximum camera zoom distance (world units).

camera_zoom_minnumber

0.3

Minimum camera zoom distance (world units).

camera_zoom_startnumber

0

Sets the initial camera zoom distance (world units).

User Interface - Controls

ui_anaglyphnumber

0

Enables anaglyph camera mode. 0 = disabled, 1 = enabled.

Options:

• 0 - Disabled
• 1 - Enabled

ui_audioboolean

true

Shows the audio/sound button.

ui_cardboardboolean

true

Shows the cardboard camera option.

ui_controlsboolean

true

Shows all viewer controls at the bottom of the viewer.

ui_first_personboolean

true

Enables first-person camera mode.

ui_fullscreenboolean

true

Shows the Fullscreen button.

ui_general_controlsboolean

true

Shows the main control buttons in the bottom-right corner.

ui_helpboolean

true

Shows the Help button.

ui_perspectiveboolean

true

Shows the 'Change Perspective' button.

ui_qualityboolean

true

Shows the quality selector button.

ui_shareboolean

true

Shows the share dialog button.

ui_stopboolean

false

Shows the 'Disable Viewer' button. When disabled, users cannot stop the 3D render once started.

ui_third_personboolean

true

Enables third-person and alternative third-person camera modes.

ui_user_counterboolean

true

Shows the user counter.

ui_vrboolean

true

Shows the 'Toggle VR' button.

User Interface - Appearance

ui_back_to_startboolean

false

Shows a button to return to the start position.

ui_color_accentstring

Accent UI color as hexadecimal code (without #).

ui_color_primarystring

Primary UI color as hexadecimal code (without #).

ui_color_secondarystring

Secondary UI color as hexadecimal code (without #).

ui_header_btn_imagestring

URL for the custom button icon in the top-right corner.

ui_header_btn_linkstring

URL for a custom button in the top-right corner.

ui_hintnumber

1

Viewer hint overlay behavior. 0 = never show, 1 = show on first visit, 2 = always show.

Options:

• 0 - Never show
• 1 - Show on first visit
• 2 - Always show

ui_infosboolean

true

Shows the info bar at the top of the viewer.

ui_infos_persistboolean

false

Shows the info bar in 3D mode. When disabled, the info bar is hidden in 3D mode.

ui_logoboolean

true

Shows the rooom logo.

ui_logo_linkboolean

true

Enables the link on the rooom logo.

ui_scroll_catchboolean

false

Enables arrow key navigation in embedded viewer.

ui_text_primarystring

Primary UI text color as hexadecimal code (without #).

ui_text_secondarystring

Secondary UI text color as hexadecimal code (without #).

User Interface - Features

ui_measurementboolean

false

Enables the measurement feature.

ui_minimapboolean

false

Shows the minimap.

ui_minimap_offsetstring

10,10

Sets the minimap position offset. Format: 'x,y' coordinates (px).

ui_minimap_pin_areascalenumber

1

Sets the area scale for pin movements on the minimap.

ui_minimap_pin_colorstring

FFFFFF

Minimap pin color as hexadecimal code (without #).

ui_minimap_pin_offsetstring

0,0

Sets the pin position offset on the minimap. Format: 'x,y' coordinates.

ui_minimap_pin_rotationnumber

0

Sets the pin rotation on the minimap (degrees).

ui_statsboolean

false

Shows the performance monitor (stats.js).

User Interface - Loading

ui_progress_bgboolean

true

Shows the background on the loading screen.

ui_progress_logostring

URL for the custom loading screen logo image.

ui_progress_minimalboolean

false

Shows only the progress bar on the loading screen, hiding other elements.

Environment

env_fogboolean

false

Enables fog in the scene.

env_fog_maxnumber

500

Sets the maximum fog distance (world units).

env_fog_minnumber

30

Sets the minimum fog distance (world units).

env_snowboolean

false

Enables snow particle system in the scene.

fx_dof_enabledboolean

false

Enables depth of field effect.

fx_dof_f_stopnumber

1

Sets the f-stop value for the depth of field effect.

fx_dof_focal_lengthnumber

200

Sets the focal length for the depth of field effect (mm).

fx_dof_focus_distancenumber

4000

Sets the focus distance for the depth of field effect (world units).

fx_glowlayer_enabledboolean

false

Enables glow layer effect.

fx_glowlayer_intensitynumber

1

Sets the glow layer intensity.

fx_glowlayer_kernelsizenumber

10

Sets the glow layer kernel size.

mirror_floornumber

1

Floor mirror effect behavior. 0 = force disabled, 1 = default per quality mode, 2 = force enabled.

Options:

• 0 - Force disabled
• 1 - Default per quality mode
• 2 - Force enabled

Mesh

highlight_colorstring

Default highlight color as hexadecimal code (without #).

max_texture_memorynumber

4096

Maximum texture memory limit (MB). Global setting for all textures.

max_texture_sizenumber

4096

Maximum texture resolution (longest side in pixels). Should be a power of 2 value (32, 128, 256, 512, 1024, 2048, 4096, etc.).

mobile_max_texture_memorynumber

200

Maximum texture memory limit on mobile devices (MB). Global setting for all textures.

mobile_max_texture_sizenumber

512

Maximum texture resolution on mobile devices (longest side in pixels). Should be a power of 2 value (32, 128, 256, 512, etc.).

mobile_texture_sizenumber

256

Default texture size on mobile devices (longest side in pixels). Should be a power of 2 value (32, 128, 256, 512, etc.).

texture_sizenumber

512

Default texture size (longest side in pixels). Should be a power of 2 value (32, 128, 256, 512, 1024, etc.).

Avatars

allow_double_jumpboolean

true

Enables double jump functionality.

allow_spatial_audio_toggleboolean

true

Shows the spatial audio toggle switch.

avatars_base_meshes_max_visiblenumber

200

Maximum number of visible avatar base meshes (shadow/abstract mesh) per scene.

avatars_codestring

Avatar configuration code with information about colors, materials, and accessories.

avatars_colorsstring

Comma-separated list of hexadecimal color codes to define the color palette for the avatar configurator.

avatars_edit_buttonboolean

true

Shows the avatar edit button in the space.

avatars_external_idstring

External ID used to identify avatars (e.g., from/to expo-x).

avatars_gestures_liststring

Comma-separated list of allowed avatar gestures. When set, only gestures from this list are shown.

avatars_labels_backgroundstring

999999cc

Avatar label background color as hexadecimal code (6 characters for color + 2 for alpha).

avatars_labels_colorstring

FFFFFF

Avatar label text color as hexadecimal code (without #).

avatars_labels_cornerRadiusnumber

16

Avatar label border radius (px).

avatars_labels_fontFamilystring

Source Sans Pro, Open Sans, Segoe UI, sans-serif

Avatar label text font family.

avatars_labels_fontSizenumber

16

Avatar label font size (px).

avatars_labels_max_visiblenumber

50

Maximum number of visible avatar labels.

avatars_labels_offsetnumber

0

Avatar label vertical offset in screen space (px).

avatars_labels_offsetWorldnumber

0

Avatar label vertical offset in world space (world units).

avatars_labels_prependstring

Text to prepend before the avatar's name in labels.

avatars_labels_thicknessnumber

1

Avatar label border thickness (px).

avatars_max_visiblenumber

5000

Maximum number of visible avatars per scene.

avatars_meshes_max_visiblenumber

50

Maximum number of visible avatar meshes per scene. Remaining avatars are shown as abstract meshes.

avatars_namestring

Specifies the avatar's name.

avatars_show_confignumber

0

Avatar config modal appearance behavior. 0 = never show, 1 = show on first visit, 2 = always show.

Options:

• 0 - Never show
• 1 - Show on first visit
• 2 - Always show

avatars_show_labelsstring

nearby

Sets the avatar label visibility behavior. Options: 'show', 'hide', 'nearby', 'hover'.

Options:

• show - Always show labels
• hide - Always hide labels
• nearby - Show labels for nearby avatars
• hover - Show labels on hover

avatars_visibleboolean

true

Shows all avatars in the scene.

avatars_voicechatstring

0

Voice chat mode. Options: '0' (disabled), '1' (enabled), 'moderator' (only moderators/hosts can talk).

Options:

• 0 - Disabled
• 1 - Enabled
• moderator - Only moderators/hosts can talk

avatars_voicechat_maxdistancenumber

30

Maximum distance for spatial voice chat (world units).

avatars_voicechat_modestring

toggle

Voice chat activation mode. Options: 'toggle', 'ptt' (push-to-talk).

Options:

• toggle - Toggle mode (click to enable/disable)
• ptt - Push-to-talk mode (hold to talk)

mobile_avatars_base_meshes_max_visiblenumber

50

Maximum number of visible avatar base meshes (shadow/abstract mesh) per scene on mobile devices.

mobile_avatars_enabledboolean

true

Shows all avatars in the scene on mobile devices.

mobile_avatars_labels_max_visiblenumber

25

Maximum number of visible avatar labels on mobile devices.

mobile_avatars_max_visiblenumber

5000

Maximum number of visible avatars per scene on mobile devices.

mobile_avatars_meshes_max_visiblenumber

30

Maximum number of visible avatar meshes per scene on mobile devices. Remaining avatars are shown as abstract meshes.

ui_textchat_expandedboolean

false

Hides the text chat on initial load.

Performance

perf_mesh_streamingboolean

false

Enables mesh streaming. Objects are loaded based on distance and size.

perf_mesh_streaming_chunk_sizenumber

50

Number of objects loaded per chunk during mesh streaming.

perf_mesh_streaming_geometriesnumber

200

Maximum number of objects displayed simultaneously when mesh streaming is enabled.

perf_object_instancingboolean

true

Enables object instancing for improved performance.

perf_texture_optimizedboolean

true

Enables optimized texture loading (KTX2 format) if available and supported by the browser.

Additional Resources

Customize Loading Screen

Learn how to customize the loading screen appearance and branding.