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.?}
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} depending on the stream trigger.
The {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 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.
Important — PANEL_IMPORT Streams
This node must not be used in a 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).
Last updated