Now reading version 18.1. For the latest, read: Port for version 21

Parent page: Schematic Objects

 A placed Port A placed Port


A port is an electrical design primitive. It is used to make an electrical connection between one schematic sheet and another sheet, or sheet symbol (through a corresponding sheet entry) in a design using multiple sheets (both flat and hierarchical designs). The name of the port defines the connection (i.e. a port on a schematic sheet connects to ports or sheet entries with the same name on other sheets in the project).


Ports are available for placement in the Schematic Editor in the following ways:

  • Click Place » Port from the main menus.
  • Click the Port button () in the directives drop-down on the Active Bar, located at the top of the workspace. (Click and hold an Active Bar button to access other related commands. Once a command has been used, it will become the topmost item on that section of the Active Bar.)
  • Right-click in the schematic editor then click Place » Port.


After launching the command, the cursor will change to a cross-hair and you will enter port placement mode. Placement is made by performing the following sequence of actions:

  • Click or press Enter to anchor the left-hand edge of the port.
  • Move the cursor to adjust the length of the port as required then click or press Enter to complete placement of the port.
  • Continue placing further ports or right-click or press Esc to exit placement mode.

Additional actions that can be performed during placement while the port is still floating on the cursor and before its left-hand edge is anchored are:

  • Press the Tab key to pause the placement and access the Port mode of the Properties panel in which its properties can be changed on-the-fly. Click the workspace pause button overlay ( ) to resume placement.
  • Press the Alt key to constrain the direction of movement to the horizontal or vertical axis depending on the initial direction of movement.
  • Press the Spacebar to rotate the port counterclockwise or Shift+Spacebar for clockwise rotation. Rotation is in increments of 90°.
  • Press the X or Y keys to mirror the port along the X-axis or Y-axis.

While attributes can be modified during placement (Tab to access the associated Properties panel), keep in mind that these will become the default settings for further placement unless the Permanent option on the Schematic – Defaults page of the Preferences dialog is enabled. When this option is enabled, changes made will affect only the object being placed and subsequent objects placed during the same placement session.

Graphical Editing

This method of editing allows you to select a placed port object in the workspace and graphically change its length, height, or location.

When a port object is selected, you can click and drag the editing handles to resize the port.

 A selected Port A selected Port

Click anywhere on the port away from editing handles then drag to reposition it. While dragging, the port can be rotated (Spacebar/Shift+Spacebar) or mirrored (X or Y keys to mirror along the X-axis or Y-axis).

The name for the port object can be edited in-place by:

  1. Single-click the port to select it.
  2. Single-click again (or pressing Enter) to enter the in-place editing mode. Sufficient time between each click should be given to ensure the software does not interpret the two single-clicks as one double-click (which would open the Properties panel).
  3. To finish editing in-place text, press Enter or use the mouse to click away from the port.
If attempting to graphically modify an object that has its Locked property enabled, a dialog will appear asking for confirmation to proceed with the edit. If the Protect Locked Objects option is enabled on the Schematic – Graphical Editing page of the Preferences dialog, and the Locked option for that design object is enabled as well, then that object cannot be selected or graphically edited. Click the locked object to select it then disable the Locked property in the List panel or disable the Protect Locked Objects option to graphically edit the object.
Non-Graphical Editing

The following methods of non-graphical editing are available:

Via the Properties Panel

Properties page: Port Properties

This method of editing uses the associated Properties panel mode to modify the properties of a port object.

The Port mode of the Properties panelThe Port mode of the Properties panel

During placement, the Port mode of the Properties panel can be accessed by pressing the Tab key.

After placement, the Port mode of the Properties panel can be accessed in one of the following ways:

  • Double-click on the placed port object.
  • Place the cursor over the port object, right-click then choose Properties from the context menu.
  • If the Properties panel is already active, select the port object.
The Port properties can be accessed prior to entering placement mode from the Schematic – Defaults page of the Preferences dialog. This allows the default properties for the port object to be changed, which will be applied when placing subsequent ports.

Editing Multiple Objects

The Properties panel supports multiple object editing, where the property settings that are identical in all currently selected objects may be modified. When multiples of the same object type are selected manually, via the Find Similar Objects dialog or through a SCH Filter or SCH List panel, a Properties panel field entry that is not shown as an asterisk (*) may be edited for all selected objects.

Via a List Panel

Panel pages: SCH List, SCH Filter

List panel allows you to display design objects from one or more documents in tabular format, enabling quick inspection and modification of object attributes. Used in conjunction with appropriate filtering - by using the applicable Filter panel or the Find Similar Objects dialog - it enables the display of just those objects falling under the scope of the active filter – allowing you to target and edit multiple design objects with greater accuracy and efficiency.

Port Actions

Right-click over a placed port to pop-up a context-sensitive menu, from which the following commands are available (on the Port Actions sub-menu) that act on that port (or all currently selected ports, where applicable):

  • Jump to Sheet Entry <PortName> - use to jump to the port's corresponding sheet entry in the parent sheet symbol that references the sub-sheet on which the port resides.
  • Toggle Port IO Type - use to toggle the I/O Type for the port.

The actual change depends on the current I/O Type as follows:

  • Unspecified remains Unspecified.
  • Output changes to Input.
  • Input changes to Output.
  • Bidirectional remains Bidirectional.
If multiple ports are currently selected, the command will appear as Toggle Selected Ports IO Type. The command will apply to all selected ports.
  • Place Harness Connector of Type <HarnessConnectorType> - use to place a harness connector (complete with respective defined harness entries) for connection to the port.
This command is only available for a port that has a defined Harness Type.
  • Jump to Port <PortName> on <SheetName> - use to jump to another port with the same name on the indicated source schematic document.
This command will be available when the Net Identifier Scope (set on the Options tab of the Project Options dialog (Project » Project Options) is set to Flat or Global.


  1. When compiling a schematic or generating a netlist, the relationship between ports and sheet symbols is determined by the Net Identifier Scope chosen for the project. This scope is defined by setting the Net Identifier Scope option on the Options tab of the Project Options dialog (Project » Project Options). When set to Flat or Global, all ports with the same name within the same or different schematic documents are considered to be electrically connected. When set to Hierarchical or Strict Hierarchical, ports only connect vertically to their corresponding sheet entries. They do not connect horizontally to other ports of the same name.
  2. The I/O Type option in the Properties panel allows you to define the port's electrical type. Choose from either Input, Output, Bidirectional,or Unspecified.
  3. Should you need to negate (include a bar over the top of) a port name, include a backslash character after each character in the name (e.g., E\N\A\B\L\E\).
  4. Port names are not used for naming nets. This means a system-generated net name will be used if no net label or power object is associated with that net.
  5. When a Port is connected to a Signal Harness, the Port becomes a Harness object. By default, the Port will change color to match the color of the Signal Harness.
  6. When a Port is connected to a Harness Connector by a Signal Harness, the Harness Type in the Properties panel is automatically populated with the Harness Type of the Harness Connector. When a Port is connected to a Sheet Entry by a Signal Harness and the Sheet Entry has a Harness Type declared, the Port will become a Harness object and change to the color of the Signal Harness. If you move the Port away from the Harness Connector or the Sheet Entry, the Port will revert back to the default color.
  7. By default, the font used for the port's Name follows the global document-level font set in the Document Font options in the Document Options mode of the Properties panel (when no objects are selected in the workspace). This can be overridden at the individual port-level with the Font settings in the Properties panel allowing you to fully control the textual presentation of ports as needed.
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.

The features available depend on your Altium product access level. Compare features included in the various levels of Altium Designer Software Subscription and functionality delivered through applications provided by the Altium 365 platform.

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.