Tags

Tags are points of interest in your 3D scene. They can display names, descriptions, icons, and custom styles.

Where Tags Come From

Tags can be created in three ways:

Line tags — created automatically when you place points on a line. Each vertex becomes a tag. These are the most common type and appear along the line path.
Standalone tags — placed manually using the Tag tool. Click on a splat to place a tag directly on the scene, independent of any line. Double-click a standalone tag in orbit mode to select and edit it.
Spatial index tags — generated automatically by the spatial indexer, which detects features in the scene using AI. These tags have a confidence score and source metadata. They can be toggled on/off in the editor and are hidden in preview by default.

Screenshot: Scene showing all three tag types — line tags along a path with bubble labels, a standalone tag placed on a wall, and spatial index tags shown as small coordinate markers

Tag Properties

Select a tag to edit its properties in the sidebar:

Name — the label shown in the scene and in the navigation list
Description — longer text shown when the tag is active (up to 200 characters)
Subtitle — a template string supporting variables like {{elevation}}
Color — background color for the tag
Text Color — label text color
Font Size — label size in pixels
Offset — X/Y pixel offset for fine-tuning label position

Screenshot: Tag properties panel in sidebar — name input, description textarea, color picker, font size, offset fields

Tag Types

Each tag has a visual type that changes how it appears in the scene:

Collapsible (default) — a small dot that expands on hover to reveal the name. Selected tags show with a blue border.
Bubble — an always-visible rounded pill with the tag name. Good for labels that should always be readable.
Text — plain text with a drop shadow, no background. Minimal and clean.
Icon — a Lucide icon (e.g., "camera", "star", "map-pin") with a rounded background. Expands on hover to show the name.
Coordinate — a map pin icon that displays the 3D coordinates. Expands on selection.

Screenshot: Five tags in a row showing each type — collapsible dot, bubble pill, plain text, icon with background, coordinate pin

Visibility Settings

Scale to Size — when on, the tag stays the same screen size regardless of distance. When off (default), tags scale with the 3D scene.
Distance Factor — controls how fast tags shrink with distance (default 1). Higher values make tags shrink slower. Only available when Scale to Size is off.
Always Visible — show the tag even when its parent line is not selected
Scene Only — tag is visible in the 3D scene but hidden from the navigation list in the overlay
Always Expanded — the label is always shown without needing hover
Split — marks this tag as a section divider on the line

Multi-Select & Batch Editing

Select multiple tags to edit them all at once. Two ways to multi-select:

Shift+Click — add or remove individual tags from the selection
Shift+Drag — draw a rectangle to select all tags within it

Screenshot: Multiple tags selected (blue borders on 4 tags), batch style editor visible in sidebar with color, type, and toggle fields

When multiple tags are selected, a batch editor appears in the sidebar. Changes to color, type, font size, and toggles apply to all selected tags at once. For name, description, and subtitle, the editor shows "multiple" — click Override to set a value across all selected tags.

Boolean toggles (Split, Always Visible, etc.) reflect the shared state — if all selected tags have the same value, the toggle shows it. Otherwise neither option is highlighted.

Template Variables

Tag names, subtitles, and line subtitles support template variables that resolve dynamically based on the tag's position in the scene. Wrap variables in double curly braces:

{{elevation}}Elevation in meters (e.g., "1542m")

{{start_elevation}}Elevation relative to line start (e.g., "+120m")

{{lat}}Latitude coordinate

{{lon}}Longitude coordinate

{{length}}Total line path length in meters

{{section_length}}Length of the current split section

{{split_index}}Ordinal of this split point (01, 02, ...). Only resolves on split tags.

GPS-based variables (elevation, lat, lon, length) require GPS reference points to be set on the project.{{split_index}} works without GPS.