Data Tagging

Binds business data (userData key-value pairs) to nodes of a 3D model. Typical use cases: industrial equipment IDs, floor/room info in buildings, e-commerce SKUs, digital twin sensor IDs, etc. Tags are exported as a standalone JSON file whose structure is directly compatible with Three.js userData — after loading the model in your frontend, attach the data by node name.

Layout

The Data Tagging page uses a three-column layout:

Area	Function
Left: node tree	Shows the full node hierarchy with a live "tagged / total nodes" counter
Center: 3D viewport	Click to select nodes; selected nodes get an outline highlight; synced both ways with the tree
Right: data editor	Edit key-value pairs for the selected node; add/remove entries and apply JSON in bulk

Basic Workflow

1. Drag in or pick a model file (free tier ≤ 50 MB, licensed ≤ 500 MB)
2. Browse the hierarchy in the node tree, or click the target node directly in the 3D viewport
3. Add key-value pairs in the editor on the right, e.g. Equipment ID = PUMP-0231, Type = Centrifugal pump
4. Tag other nodes the same way, then click "Export JSON" in the toolbar to save

Toolbar

Button	Description
Import	Batch-import tags from a JSON file, auto-matched by node name
Preview	Preview all tagged nodes at once, with unified editing
Repair	Scan and clean up orphaned data (tags left behind after a node was deleted) and redundant data, keeping tags consistent with the model
Clear	Remove all tags from the current model
Export JSON	Export all tags as a JSON file for archiving or re-import

Key Presets & Bulk Apply

• Common key names (e.g., id, name, type) can be inserted quickly via presets to avoid retyping
• The editor supports bulk JSON apply: paste a JSON object to write multiple key-values to the current node in one click

Export Format

The exported JSON looks like this (default filename {model-name}-userdata.json):

{
  "meta": {
    "version": "1.0",
    "createdAt": "2026-08-02T10:00:00.000Z",
    "markedNodeCount": 2,
    "totalFieldCount": 3,
    "modelFileName": "factory"
  },
  "nodes": {
    "001": {
      "name": "Pump_0231",
      "data": { "EquipmentID": "PUMP-0231", "Type": "Centrifugal pump" }
    }
  }
}

The data field of each node is a plain key-value object — the same structure as Three.js object.userData, so you can assign it directly.

Tips

Node names are the matching key

JSON import and data repair both match on node names. Make sure node names are unique and meaningful at the modeling stage — avoid auto-generated names like Cube.001.