Multiple Top-Level Documents

Parent category: Violations Associated with Documents

Default report mode:


This violation occurs in hierarchical designs where two or more schematic sheets are at the top-level of the structure.


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. A notification is also displayed in the Messages panel in the following format:

Multiple top level documents: <SheetName> has been used,


SheetName is the name of the schematic document currently being used as the top-level sheet.

Recommendation for Resolution

This issue typically arises due to the sheet symbol on the true top sheet not targeting the intended sub-sheet correctly. To resolve this issue, first determine which schematic sheet is the intended sub-sheet. Check to see if a sheet symbol has been placed for the intended sub-sheet on the top-level schematic:

  • If a sheet symbol does not exist, create it either by manual placement or by right-clicking on the sub-sheet then using the Sheet Actions » Create Sheet Symbol From Sheet command.
  • If the sheet symbol exists, check the symbol's Filename field and ensure that it references the sub-sheet.

Upon recompiling, the hierarchy will be resolved and the error will disappear from the Messages panel.


You are reporting an issue with the following selected text and/or image within the active document: