# Automation Builder

Couchdrop automations are built using a visual builder that requires no code. The builder supports multiple steps through primary actions and sub-actions. 

## How the builder works

Automations have two main pathways. Moving **down** the tree are primary actions. Moving to the **right** are sub-actions. 

See the sample image below of an automation created with the visual builder. 

<figure><img src="/files/VlAtNgFN3zMz6QRC3OWa" alt=""><figcaption></figcaption></figure>

It's important to understand Primary Actions and Sub-actions and the processing order to avoid errors.&#x20;

## Primary Actions

Primary actions act on the **original** file. This means that when there is a Copy action, any sub-actions apply to the copy and do *not* apply to the original file. Because of this, some actions like "Rename File" are unavailable in Primary actions to avoid errors.&#x20;

## Sub-actions

Sub-actions are branches to the right. These actions act on the **modified** file if a second file has been created due to a copy or similar action. If there is only one file, Sub-actions act on the **original** file and function essentially the same as primary actions.&#x20;

## Processing Order

Automations are processed t**op-to-bottom, left-to-right**.  This means that sub-actions occur before the next primary action.

{% hint style="warning" %}
If a sub-action fails, then Couchdrop will NOT continue to process any child actions
{% endhint %}

The builder shows the order that actions will be processed by showing them at different levels, with higher levels processed first. Processing order is also indicated by the letter groupings and numbered subactions.&#x20;

See the image below for an example of processing order in a multi-step workflow.

<figure><img src="/files/Og4YVg4yXIJPiDEMRBbN" alt=""><figcaption></figcaption></figure>

All A group actions will occur first in numerical order, followed by the B group, and so on.

### Modifying an automation&#x20;

Once an action is chosen, the action type cannot be changed directly. Instead, the action must first be deleted and then replaced with a new action.&#x20;

When deleting an automation action, if the action has sub-actions, those sub-actions will be deleted as well. When this applies, you will receive a warning explaining the number of actions that will be deleted and will need to confirm deletion.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.couchdrop.io/features/transfer-automations/automation-builder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.