rename_port - 2023.2 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
Release Date
2023.2 English

rename a port


rename_port ‑to <arg> [‑quiet] [‑verbose] <port>...


Name Description
-to New name
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution
<port> Port to rename




Rename a single port in the current synthesized or implemented design.

Tip: You cannot rename individual bits of a bus port, but you can collectively rename the whole bus.
Netlist editing changes the in-memory view of the netlist in the current design. It does not change the files in the source fileset, or change the persistent design on the disk. Changes made to the netlist may be saved to a design checkpoint using the write_checkpoint command, or may be exported to a netlist file such as Verilog, VHDL, or EDIF, using the appropriate write_* command.
Note: Netlist editing is not allowed on the elaborated RTL design.

Changes to the names of cells, nets, pins, and ports, will also affect the design constraints defined in the in-memory design. Constraints are automatically modified to target the new object name, however these are not written back to the source XDC file. Saving the modified in-memory design using write_checkpoint will save both the renamed objects and modified constraints.

This command returns nothing if successful, or an error if it fails.


-to <arg> - (Required) Specify the new name to assign to the specified port. Specified names can not contain Tcl special characters: '"\{};$#

-quiet - (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
Note: Any errors encountered on the command-line, while launching the command, will be returned. Only errors occurring inside the command will be trapped.
-verbose - (Optional) Temporarily override any message limits and return all messages from this command.
Note: Message limits can be defined with the set_msg_config command.

<port> - (Required) Name of the port to rename.


The following example renames the specified bus port:

rename_port -to wbInputData wbInDat