BD - BD - 2026.1 English - UG892

Vivado Design Suite User Guide: Design Flows Overview (UG892)

Document ID
UG892
Release Date
2026-06-23
Version
2026.1 English

To place a block design under revision control, check in the BD file and the associated XCI files in /project_name.srcs/sources_1/bd/bd_name. Also check in the IP repositories that the block design uses. The BD file stores each IP configuration on the canvas and the connections between IP blocks.

The XCI files under the BD source directory store the IP customizations after parameter propagation runs during BD validation. When you rebuild the project from the revision control repository, make sure the BD file and the XCI files under the BD directory are writable. This requirement is a limitation of the current Vivado version.

You can preserve a BD using the write_bd_tcl command. This command generates a Tcl script that recreates the BD. The script preserves IP customizations, IP connections, and all BD properties affecting the design.

Note: To compare block diagram versions, see Vivado Design Suite User Guide: Designing IP Subsystems Using IP Integrator (UG994) for details on the diffbd utility.
Note: When a block design container exists in a project, the source BD resides in the .srcs folder. Instances uniquified by parameter propagation reside in the .gen directory. When you restore the project, only the source BD appears in the project. Instance BDs appear as missing files in the hierarchical sources view. This behavior is expected. Regenerating the parent BD recreates block design container instance BDs and restores the original project structure.