SCOPED_NAME - SCOPED_NAME - 2025.2 English - UG912

Vivado Design Suite Properties Reference Guide (UG912)

Document ID
UG912
Release Date
2025-11-20
Version
2025.2 English

SCOPED_NAME property contains the scoped name of a netlist element with respect to a particular hierarchical instance in the design. This enables to query the netlist objects within IP/design hierarchy more efficiently than with the property NAME because the elements are only searched from the current_instance, not from the top-level. For example, query commands using this property can be written such as get_cells -hier -filter { SCOPED_NAME =~ x/y/*z }, removing the need of leading '*/'. This reduces the search space for the pattern matching. Whenever Vivado reads an IP XDC File, it switches the scope to the IP instance using the current_instance command. The query commands using SCOPED_NAME search within the IP hierarchy without the '*/' pattern, making the search runtime efficient.

Architecture Support
All architectures.
Applicable Objects
  • cells (get_cells)
  • pins (get_pins)
  • nets (get_nets)
Value
Not applicable

Syntax

XDC Syntax Example
current_instance sixty
get_nets -hier -filter { SCOPED_NAME =~ lsbcount/C* }