Skip to content

UI-Builder-UE

UI Builder shows "Unknown ID" in Control Fields

This issue occurs when Control Fields lose their connection to the Control Objects they were originally linked to.
As a result, the UI Builder cannot find the corresponding Controllers or Templates and displays "Unknown ID".

Symptoms

  • "Unknown ID" is displayed in the UI Builder interface.
  • The Control Objects tab is empty.
  • Warning indicators appear next to affected elements.

Root Cause

The problem usually appears after: - Project folder paths have changed (for example, when moving or cloning a project). - Templates were re-imported or duplicated in a different location. - Old Control Object references were not updated.

When this happens, UI Builder still tries to use the old link (path), which no longer exists.

Solution

  1. Open Erizos Studio.
  2. Load the relevant Show.
  3. Go to Templates Manager.
  4. Select the project.
  5. Right-click on the affected Template → click Re-link to Selected.
  6. The project will now update to the new directory path.

After relinking, the template should point to the correct location.

2. Reimport Control Objects

  1. Open the corresponding UI in UI Builder.
  2. Go to the Control Objects tab.
  3. Click the Reimport icon.
  4. Wait until the Control Objects are reloaded.

Now, the Controller IDs should be detected correctly.

3. (Optional) Restart Studio Server

If the issue still persists: 1. Open Studio Admin. 2. Go to Maintenance → click Restart.

Important Notes

  • Remove duplicate templates:
    If you have old or duplicate templates pointing to irrelevant paths, delete them.
    Otherwise, they may cause confusion or new linking issues later.

  • Keep consistent folder structure:
    Always use the same directory naming between projects to avoid path mismatches.

Summary

Issue Root Cause Solution
Unknown ID in UI Builder Unlinked or missing Control Fields Re-link templates → Reimport Control Objects → Restart Studio Server

After completing these steps, the Control Objects should reappear correctly in the UI Builder, and all Unknown ID warnings will disappear.