# Cosmo Add Asset To Project Action

The **Cosmo Add Asset to Project Action** node allows you to add an asset to one or multiple existing Cosmo projects directly from a stream.

The node creates a new asset entry in Cosmo and attaches it to the specified projects. The generated asset IDs are written to the node results and can be retrieved using the pattern:

`nodeID_index` when using the wildcard [{node.result.?}](https://docs.helmut.de/helmut4-releases/helmut4-components/streamdesigner/wildcards/result-or-return-wildcards-2/node-result)

Example: `58ff3a15-e295-4188-8045-6231aece5990_0`

These IDs can be used by subsequent nodes within the same stream.

#### General Behavior

To add an asset, one or more project IDs must be provided in the **Project ID List** field.

A distinction is made between:

* **Asset Path** — the physical storage location including filename and extension
* **Asset Name** — the logical name stored in the database and shown in Cosmo, Premiere Pro, and After Effects

A **breadcrumb** (folder structure inside the project) can also be defined.\
The breadcrumb may be set manually or filled using the wildcard [{job.breadcrumb}](https://docs.helmut.de/helmut4-releases/helmut4-components/streamdesigner/wildcards/job-related-wildcards-32/job-breadcrumb) depending on the stream trigger.

The [{job.breadcrumb}](https://docs.helmut.de/helmut4-releases/helmut4-components/streamdesigner/wildcards/job-related-wildcards-32/job-breadcrumb) wildcard is typically available for:

* Auto Import
* Web Upload

It is typically not available for:

* Export workflows
* Watch Folder workflows

#### Input Parameters

**Project ID List**\
List of project IDs to which the asset should be attached.

**Asset Path**\
Full file path of the media file including filename and extension.

**Asset Name (optional)**\
Name stored in the database and displayed inside Cosmo and supported host applications.

**Proxy Path (optional)**\
Full file path of the proxy media file.

**Breadcrumb (optional)**\
Defines the folder and subfolder structure inside the project.

#### Synchronization & Metadata Options

**Add Metadata**\
If enabled, metadata will be written to the asset.

**Add Marker**\
If enabled, markers will be created for the asset.

**Auto Sync**\
If enabled, the asset is automatically synchronized when the project is opened.\
If disabled, the asset will appear as pending synchronization in the panel and must be synced manually.

**Trigger Auto-Import**\
Triggers the [AUTOIMPORT](https://docs.helmut.de/helmut4-releases/helmut4-components/helmutio/streams/io-event-triggers/autoimport) event when the asset is synchronized to the project.

#### Name and Location Protection

**Don’t Change Name**\
If enabled, the asset name will not be overwritten during synchronization if an editor renames the clip inside Premiere Pro or After Effects.\
This is especially useful for auto-import workflows where editors rename clips manually.

The updated names can later be written back to the Cosmo database by re-indexing the project.

**Don’t Change Breadcrumb**\
If enabled, the asset location inside the project will not be overwritten during synchronization if the editor moves the clip within Premiere Pro or After Effects.\
This allows editors to reorganize bins without the panel moving the asset back to its original location.

#### Panel Synchronization Behavior

When **Auto Sync** is disabled, assets requiring synchronization are indicated in the panel.\
The panel displays a counter showing how many assets still need to be synchronized or updated. Synchronization can then be triggered manually.

#### Execution

* Can run in a stream and attach assets immediately to Cosmo projects
* Supports multiple target projects
* Returns created asset IDs for further processing
* Supports asynchronous execution

This node is typically used in ingest, auto-import, web upload, or automated delivery workflows where media must automatically appear inside editorial projects.

{% hint style="warning" %}

#### Important — PANEL\_IMPORT Streams

This node must **not** be used in a [PANEL\_IMPORT](https://docs.helmut.de/helmut4-releases/helmut4-components/helmutio/streams/io-event-triggers/panel_import) stream.

During a PANEL\_IMPORT workflow, the asset is already imported and fully registered in Cosmo by the panel. Executing this node in that context would attempt to create the same asset again and can lead to duplicate entries or unexpected behavior.

Use this node only in workflows where the asset does **not yet exist** in Cosmo (e.g., ingest, watch folder, auto-import, or upload workflows).
{% endhint %}

<figure><img src="https://content.gitbook.com/content/cJYkTyk9qgh7aCR6dHIm/blobs/15fpVDZCca4RW5154f8r/image.png" alt="" width="352"><figcaption><p>Cosmo Add Asset To Project Action</p></figcaption></figure>