> For the complete documentation index, see [llms.txt](https://docs.opencutlist.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencutlist.org/features/outliner.md).

# 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="/files/9zDTrYm5UCj19UWbwYzJ" 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="/files/iXatfbjqbQI19nBhocpj" alt=""><figcaption></figcaption></figure> <figure><img src="/files/CavD8KuT9GnEcWVEJQrG" alt=""><figcaption></figcaption></figure> <figure><img src="/files/yH8ESgBCB9eVp11jvf1j" 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="/files/TQ4BEd11qB2Tsf5i3DG1" alt=""><figcaption><p>Added part size</p></figcaption></figure> <figure><img src="/files/KUJ0XaVGtaegCgeqfuOn" alt=""><figcaption><p>Added instance name</p></figcaption></figure> <figure><img src="/files/dmGff3jrgTvPd0nKYjuz" alt=""><figcaption><p>Added material name</p></figcaption></figure></div>