KB: Duplicate Item ID (HRID) Error When Creating Server Items

Solution Details

Error when creating items with existing IDs

The "Duplicate item HRID" error appears when attempting to create a Server Item using an Item ID (HRID) that already exists in an Altium 365 Workspace or Altium Enterprise Server. 

Although the item may not be visible in Altium Designer or the server web interface, it still exists in the backend and prevents reuse of the same Item ID.

Underlying causes of hidden or reserved Item IDs

This issue is typically caused by one or more of the following conditions:

• Soft-deleted item in Trash: The item remains in the Trash folder and must be permanently removed.
• Hidden soft-deleted planned item: Items created without release remain in the Planned lifecycle and may transition to a hidden Deleted state when removed.
• Legacy server limitation: Older Altium Enterprise Server versions do not expose deleted planned items, preventing proper cleanup.
• Reserved Item ID for abandoned project release items: When a project release item is abandoned, its Item ID remains reserved by the server and cannot be reused.

Available approaches to resolve Item ID conflicts

• Check the Trash and permanently delete the conflicting item
• Upgrade to Altium Enterprise Server version 7.2.5 or later
• Use Altium Designer 19.1.9 or earlier to locate hidden deleted items
• Address conflicts caused by abandoned project release items using the related Knowledge Article

Steps to locate and remove conflicting Item IDs

1. Remove the item from the Trash
   1. Open the Altium 365 or Altium Enterprise Server web interface.
   2. Navigate to the Trash folder.
   3. Locate the item with the conflicting Item ID (HRID).
   4. Perform a permanent (hard) delete.

   Warning: Permanent deletion is irreversible. Ensure the item is no longer needed before proceeding.

2. Upgrade the server to expose hidden items
   1. Verify the current Altium Enterprise Server version.
   2. If the version is older than 7.2.5 (Build 13, dated 24 June 2025), perform an upgrade.
   3. After upgrading, return to the Trash folder.
   4. Locate and delete previously hidden planned items.
3. Use an earlier Altium Designer version to locate hidden items
   1. Install Altium Designer 17, 18, or 19 (recommended: 19.1.9).
   2. Launch the application.
   3. Connect to the appropriate server:
      • For Altium 365: sign in with credentials (SSO is not supported in older versions; use a non-SSO account if required).
      • For Altium Enterprise Server: ensure licensing and connect to the server instance.
   4. Open the Explorer panel.
   5. Click the settings (gear) icon and enable:
      • Load All Pages
      • Show Hidden Revisions
      • View » Classic View
   6. Search for the conflicting Item ID (HRID).
   7. Verify the item appears with lifecycle state Deleted.
   8. Permanently delete the item.
   9. Confirm the item no longer appears in Trash or search results.
   10. Recreate the Server Item using the same Item ID.

   

4. Address conflicts caused by abandoned project release items
   1. If the error occurs when creating a new project release item using the same Item ID as a previously abandoned item.
   2. Note that the Item ID remains reserved by the server even when the item is in an abandoned lifecycle state.
   3. Refer to the related knowledge base article for detailed resolution steps and supported approaches: KB: Duplicate item HRID error for new release item

Additional Notes

• Ensure Item IDs (HRIDs) are unique before creating new Server Items.
• Use older Altium Designer versions only for cleanup purposes.
• Newer versions do not expose items with a Deleted lifecycle state.

References

Product Documentation

• Working with Items
• Managing Item Revision Lifecycle
• Configuring and Administrating Your Workspace - Explorer Panel
• Altium Enterprise Server 7.2 Release Notes (Fix 48205)

Knowledge Base Articles

• KB: Duplicate item HRID error for new release item - Abandoned Items Scenario
• KB: Delete items from Altium 365 Workspace permanently