Change the parent instance

  • Release version: Zurich
  • Updated September 23, 2025
  • 1 minute to read
  • Change the parent for a development instance to modify the instance hierarchy.

    Before you begin

    Role required: admin

    About this task

    Changing the parent initiates a complete comparison between the development instance and the new parent instance. Confirm that the new parent instance was cloned recently from an appropriate instance. Verification optimizes comparison speed and reduces the number of collisions and local changes that need review after. Before you change the parent instance, confirm that the change doesn’t conflict with your change management process or other development efforts.

    Procedure

    1. On the development instance, navigate to Team Development > Team Dashboard.
    2. In the control panel, select Change.
    3. Select the remote instance that you want to use as the parent and select Select.

      Alternatively, select the link to define a new remote instance. Then, repeat steps 1–3 and select the remote instance you defined.

      The system initiates a reconcile, which compares the local instance to the parent. A list of local changes is generated and the number of changes are calculated that are ready to pull from the parent.

    4. On the completion page, select Team Dashboard.
    5. Pull versions from the parent instance and resolve any collisions.
    6. Review the local changes list and queue or ignore changes, as appropriate.