# Outliner

{% hint style="danger" %}
This page is currently being written.
{% endhint %}

{% hint style="info" %}
The Outliner was introduced in version 7.0.0.
{% endhint %}

{% embed url="<https://youtu.be/7iXH7ZBH27k>" %}

## Advanced features

### Deep Rename Parts

This feature allows you to **rename** **multiple parts** in a single operation using a Ruby formula that will be applied to each part.

Right-click on the instance from which you want to start the renaming. For example, a group containing multiple parts and select the *Rename Parts...* item.

{% hint style="success" %}
If the instance is part of a selection, all instances in the selection will be taken into account by the function.
{% endhint %}

<figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FPfRV7J9oOfkyk4aW9nhV%2FCapture%20d%E2%80%99e%CC%81cran%202025-12-13%20a%CC%80%2009.03.59.png?alt=media&#x26;token=4919e800-b717-4a4a-bf3b-7bba948875fa" alt=""><figcaption></figcaption></figure>

A dialog box will open where you can define the formula that will be applied to all the parts. This [formula](https://docs.opencutlist.org/features/parts/formulas) gives you access to variables that contain the parts' information. Type the `@` character to open the variables list.&#x20;

<div><figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2F3tQ1FWBTtK4MEkSlNm0t%2FCapture%20d%E2%80%99e%CC%81cran%202025-12-13%20a%CC%80%2009.14.23.png?alt=media&#x26;token=24f4996c-1cfc-47e1-9678-3a259282638a" alt=""><figcaption></figcaption></figure> <figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FDHU8ZuDBAM3t9bk7cJ1t%2FCapture%20d%E2%80%99e%CC%81cran%202025-12-13%20a%CC%80%2009.17.43.png?alt=media&#x26;token=6c8278ae-3a46-4ea2-9ed5-eb50d5bdfe24" alt=""><figcaption></figcaption></figure> <figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2F53RvV9fJr8FVbMWm9VxL%2FCapture%20d%E2%80%99e%CC%81cran%202025-12-13%20a%CC%80%2009.14.48.png?alt=media&#x26;token=8a048d82-db57-4cb2-91e9-65d9ed2cb0f7" alt=""><figcaption></figcaption></figure></div>

As you enter your formula, a preview of the modified parts' names will be displayed.\
To confirm the operation, click **Rename**.

{% hint style="success" %}
The system will ensure that component definitions are **unique** in the case of different names at the output.
{% endhint %}

{% hint style="info" %}
Note that a part is not renamed if the formula returns an empty string.
{% endhint %}

#### Example of usages

<div><figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FXcyb1hivz6kwd1wHlVF8%2FCapture%20d%E2%80%99e%CC%81cran%202025-12-13%20a%CC%80%2009.29.32.png?alt=media&#x26;token=2a1d0d68-288f-450a-bc5d-21de4118a5cb" alt=""><figcaption><p>Added part size</p></figcaption></figure> <figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FC3NKk0vZbUc3q0mncBC4%2FCapture%20d%E2%80%99e%CC%81cran%202025-12-13%20a%CC%80%2009.33.22.png?alt=media&#x26;token=525d8e10-dc80-4432-ba80-8e8381bee9b3" alt=""><figcaption><p>Added instance name</p></figcaption></figure> <figure><img src="https://2764382921-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUSHuV5bThAGZxy7OHb-1972196547%2Fuploads%2FQNtcItmTFtiUM1RClDVW%2FCapture%20d%E2%80%99e%CC%81cran%202025-12-13%20a%CC%80%2009.36.15.png?alt=media&#x26;token=52626550-5084-48fd-877d-8c7c651f3da7" alt=""><figcaption><p>Added material name</p></figcaption></figure></div>