Altium NEXUS Documentation

WorkspaceManager_Err-UniqueIdentifiersErrorsUnique Identifiers Errors_AD

Created: March 24, 2021 | Updated: March 24, 2021
This documentation page references Altium NEXUS/NEXUS Client (part of the deployed NEXUS solution), which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer (with Altium Designer Enterprise Subscription) and a connected Altium 365 Workspace. Check out the FAQs page for more information.
All Contents

Parent category: Violations Associated with Documents

Default report mode:


This violation occurs when two circuit elements (including Ports, Sheets, Components, Component pins, Sheet symbols, parameters, etc.,) across source schematic sheets in a design have the same Unique ID associated to them.

Note that the compiler does not detect duplicates of connectivity-independent UIDs, such as those for Parameter Sets, for example. However, duplicates of these UID types are automatically corrected when a document is loaded.


If compiler errors and warnings are enabled for display on the schematic (enabled on the Schematic - Compiler page of the Preferences dialog), an offending object will display a colored squiggle beneath it. Hovering over the object will display a pop-up hint that summarizes the violation. A notification is also displayed in the Messages panel in the following format:

Unique Identifiers Errors: found at <Location1> and < Location2>


  • Location1 is the X,Y coordinates for the first object found with a Unique ID error.
  • Location2 is the X,Y coordinates for the second object found with a Unique ID error.

Recommendation for Resolution

Reset the Unique ID's for the offending objects as required. This can be done on a global level using the Tools » Convert » Reset Component Unique IDs command. This command encompasses two processes, which are effectively performed in sequence:

  1. Duplicate UIDs are detected within the design and corrected by resetting (regenerating) the UID value for one of the objects in the duplicate pair.
  2. The UIDs for Parts and Sheet symbols are reset (regenerated).

Note that the command can be applied to the active document, all source schematics in the active project, or all open schematics (regardless of the project to which they belong).


  1. With the exception of component UniqueIDs, duplicate UIDs are automatically detected and corrected when a Schematic document is loaded in Altium NEXUS, therefore, removing the need for user intervention. The detection/correction process works through all UIDs in the design including Set Parameters and parameter additions to Ports, Nets Labels, Directives, Sheets, and so on. This correction is important for Parameter UIDs in particular, where duplicate UIDs can cause obscure Rule misbehavior and annotation errors in projects with Variants.
  2. Components that have duplicate UIDs are not processed by the automatic correction on document load. Component UIDs are fundamental to design connectivity, and any duplicate UIDs (which are very unlikely to occur) are best resolved by intention when detected by the Compiler.
  3. When any of the corrective measures have been applied to resolve duplicate UniqueIDs - multiple or automated UID changes - the related Schematic-to-PCB links need be reinstated to maintain design connectivity. Use the PCB editor’s Edit Component Links dialog to perform the required updates (Project » Component Links).
  4. Object hints will only appear provided the Enable Connectivity Insight option is enabled on the System - Design Insight page of the Preferences dialog. Use the controls associated with the Object Hints entry in the Connectivity Insight Options region of the page to determine the launch style for such hints (Mouse Hover and/or Alt+Double Click). 


Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
200 characters remaining
You are reporting an issue with the following selected text
and/or image within the active document: