> For the complete documentation index, see [llms.txt](https://docs.d5render.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.d5render.com/workflow/general-questions/re-linking-file-process-introduction.md).

# Re-linking File Process Introduction

If you change the path or name of the model file, you can update the D5 project using the re-linking function, ensuring that previous lighting and material settings are preserved. This process is compatible with **SU/SketchUp** and **3dsMax** real-time plug-ins.

* Data synchronisation after model renaming/path changes
* Avoid duplicate light overlays
* Preserve historical material parameters
* Inheritance of model attributes

## Workflow

### Method 1: Models linked to .drs before

**Scenario:** The model has been linked to a D5 project, but the local storage path or name has been altered.

#### **Operating Steps:**

**Activate Connection**

1. Click the ‘Connect to D5 Render’ button in the DCC plug-in.
2. Select the ‘Sync local Project’ mode in the pop-up window.

<figure><img src="https://3611830798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjbN1iGmN_HBnj_fyU9%2Fuploads%2Fvm7XX2it0VNIjK1MUOrw%2Fimage.png?alt=media&amp;token=b4ee741c-4217-408a-9b9f-a06439be4bd2" alt="" width="374"><figcaption><p>Step 1</p></figcaption></figure>

**Select the model to replace**

Tick the target model to be replaced in the popup window. (D5 materials will be inherited after replacement)

<figure><img src="https://3611830798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjbN1iGmN_HBnj_fyU9%2Fuploads%2FKppIuZ9xROhwnjY6yaau%2Fimage.png?alt=media&amp;token=ac7a39a7-c468-4ac7-add6-3bba330b112a" alt="" width="424"><figcaption><p>Step 2</p></figcaption></figure>

Click ‘Replace and link’ to complete the synchronisation.

### Method 2: Open .drs and the modeling file together

**Scenario:** need to update both the model file and the associated project at the same time

#### **Workflow:**

1. Open the D5 project file (.drs) and the modified model file at the same time.
2. Click the ‘Connect to D5 Render’ button in the DCC plug-in.

<figure><img src="https://3611830798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjbN1iGmN_HBnj_fyU9%2Fuploads%2FVIZkhoZAOLTGSDD8SL8B%2Fimage.png?alt=media&amp;token=f6188570-3ed2-4197-9c01-e7ddf81c27a2" alt="" width="563"><figcaption><p>Step 1</p></figcaption></figure>

3. Select the corresponding model in the Replacement pop-up window.
4. Tick the ‘’Light‘’ / ‘’Material‘’ options as required.
5. Click ‘Replace and link’ to complete the synchronisation.

<figure><img src="https://3611830798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjbN1iGmN_HBnj_fyU9%2Fuploads%2FbBi45l93E4cYqSjghAK8%2Fimage.png?alt=media&amp;token=1aacf0af-ead7-4067-97a6-d44ee73b5a07" alt="" width="424"><figcaption><p>Step 2</p></figcaption></figure>

<figure><img src="https://3611830798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjbN1iGmN_HBnj_fyU9%2Fuploads%2F6cimOdjlINH8zG824AZA%2Fimage.png?alt=media&amp;token=27b08b5a-e70c-4a91-b3e1-f974e07e8f91" alt="" width="563"><figcaption><p>Replace and link logic</p></figcaption></figure>

### Option Description:

* Tick ‘’Light‘’: Replace the light group with the same ID (historical parameters are preserved)
* Tick ‘Material’: Replace materials with same names (historical parameters are preserved).

{% hint style="warning" %}
**Note:**

* ‘’Light‘’ replacement only supports SU/3dsMax LiveSync plug-ins.
* No light/material ticking options for non-real-time plug-ins and direct imported models.
  {% endhint %}

## FAQs

### Q1: Why does the DCC prompts "Please retry after exit rendering mode or finish the rendering within D5 Render"?

A：

The general situation is: after entering the picture/video mode in D5, and then performing the increase or decrease model operation in DCC and transmitting new data (real-time update or manual update) to D5, this error will occur.

<figure><img src="https://3611830798-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjbN1iGmN_HBnj_fyU9%2Fuploads%2F760rca4sE0h9baqtQ3rW%2Fimage.png?alt=media&amp;token=987450c8-21fa-4bca-9389-0c5821f8a409" alt="" width="238"><figcaption></figcaption></figure>

In this case, exit the picture/video mode, and then re-associate the synchronization.
