Documentation

​
​

Development

User Acquisition

Monetization

Industry

Unity Version Control

DevOps

On-prem

Gluon

Editor plug-in

Open Unity Dashboard

Unity Version Control

​
​
Unity Version Control
  • Overview
  • Cloud Repositories organization update
  • Installation
  • Use UVCS with the Unity Editor
  • Unity Version Control plugins
  • Concepts
  • Tutorials
    • Migrate from Git
    • Migrate from Perforce
    • Version Control settings
    • Configure the client
    • Version Control workflow
    • Version Control tools
      • Enable dynamic workspaces (Windows)
      • Create a label
      • Create an attribute
      • Create a mergebot
      • Use Smart Locks
      • Use Xlinks
      • Use Unity Samples
      • Use triggers
      • Transfer project to a different organization
  • On-Prem
  • Gluon
  • CLI and shortcut references
  • Release Notes
  1. Unity Version Control (previously Plastic SCM)

Use Xlinks

Create Xlinks to connect repositories in Unity Version Control.
Read time 3 minutes
Last updated 10 months ago
You can use Xlinks to share components between different repositories. For more information about what Xlinks are and how you can use them, refer to Xlinks.

Use Xlinks in the GUI

Create an Xlink

You can create Xlinks in the UVCS desktop application.
Note
You can only create partial Xlinks through the command line.
  1. In the Workspace Explorer, right-click the directory or existing Xlink that you want to create an Xlink inside of.
  2. Select Create Xlink.
  3. In the dialog that opens, select the target changeset:
    1. Select the target UVCS server.
    2. Select a repository inside the server.
    3. Select a changeset inside the repository.
You can also optionally set the writable and relative server options for the Xlink:
  • Writable: allows you write permissions in the Xlinked repository.
  • Relative server: the Xlink gets the local version of the repository (recommended when you use replicated repositories).
If you create a writable Xlink, you can set the expansion rules.

Modify an Xlink

To modify an Xlink, right-click on the Xlink and select Edit Xlink. In the Edit Xlink dialog, you can edit the target changeset of the Xlink. If you have a writable Xlink, you can edit the expansion rules.

Use Xlinks in the CLI

Create an Xlink

To create an Xlink, you need to use the 
cm xlink
command. For more information, you can refer to the 
xlink
 CLI reference, or use the 
cm help xlink
command.
For example, you can create the following Xlink:
cm xlink component1 / 1@mylibrary

Parameter

Description

component1
The directory in the project repository that points to the mounted 
mylibrary
component. This directory must not already exist in the repository. The xlink command creates an item for the directory, and throws an error if a file of the directory already exists with the same name.
/
The directory in the target repository.
1
The changeset number in the target repository.
mylibrary
The target repository. Together with the changeset, this forms a changeset specification. In this case, there is no server specified. If you do specify a server, the spec looks like the following: 
1@mylibrary@servername:8087
.
Note
You can also specify a label instead of a changeset. Since a label is a pointer to a changeset, the two specifications are interchangeable. If you specify an xlink with a label, the xlink only uses the label to retrieve the changeset and sets the xlink to it. This means that if you move the label, the xlink still points to the original changeset.

Create a partial Xlink

Use a partial Xlink to mount a subdirectory in your repository. A partial Xlink has to be read only. For example:
cm xlink component1Src /src/dll cs:478@mylibrary
In the above example, the Xlink ensures that any files in 
cs:478@mylibrary
that exist in the subdirectory 
/src/dll
appear as read only files under the 
/component1Src
directory in the current workspace.

Create a writable Xlink

To create a writable Xlink, you need to specify the 
-w
modifier, for example:
cm xlink -w component1 / 1@mylibrary

Modify an Xlink

To modify an existing Xlink, you can use the 
-e
modifier. For example, you can modify an existing Xlink 
component1
to point to changeset 5 on repository 
mylibrary
:
cm xlink -e component1 / 5@mylibrary
For more information about how to modify an Xlink in the command line, refer to the 
xlink
 CLI reference, or use the 
cm help xlink
command.
Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page

    • Use Xlinks in the GUI

      • Create an Xlink

    • Modify an Xlink

    • Use Xlinks in the CLI

      • Create an Xlink

        • Create a partial Xlink

        • Create a writable Xlink

      • Modify an Xlink

Report a problem with this page