Figma metadata node and re-imports¶
The Kanzi Studio plugin tracks every imported asset in a hidden node called Figma Bridge Metadata directly under RootNode. The Description field carries a JSON payload. On creation the plugin sets two properties that keep the node out of the runtime and out of the project view:
IsDisabled = true: the same value the Kanzi Studio UI writes when you toggle Disable KZB Export under the Resources category. This both excludes the node from the runtime.kzband prevents it from rendering.ProjectItem.IsHidden = true: the node does not appear in the Kanzi Studio project tree.
The metadata is stored in the .kzproj and is not exported to the .kzb.
Showing the node¶
The node is hidden by default. To show the metadata node:
In the Kanzi Studio plugin, open Settings > Show log panel.
In the Debug Log toolbar, click the eye icon.
The node then appears in the scene tree with its JSON metadata visible in the Description property.
How re-imports match¶
Imported nodes are stamped with their Figma node ID in the Kanzi item Description. Re-imports match nodes by ID, not by name. Re-imports survive the following changes:
Rename of the imported Kanzi node.
Move to a different parent.
Delete. The next re-import creates a fresh node.
Version chain¶
Every transfer of the same Figma asset adds an entry to a per-block version chain visible in the Inspector. In the Inspector:
Click New to create a fresh version.
Click an existing version entry to overwrite that entry instead of creating a new one.
To roll back, select the older version node manually and delete the newer one.
Warning
Do not edit the Description property of an imported node by hand. Kanzi Figma Importer uses it to track Figma identity. Modifying the description breaks re-import matching for that node.
History maintenance¶
Warning
The two history-maintenance actions described below are currently non-functional. As a workaround, delete the Figma metadata node manually from the scene tree (see Showing the node) and then re-import.
Two Settings actions reset the bookkeeping. See Settings.
Delete History: wipes all importer metadata. Kanzi items stay; only the re-import bookkeeping resets.
Cleanup History: removes orphan entries that reference Kanzi items you have deleted by hand.