For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

Your first automation

Send every new upload into a "To review" collection automatically. Ten minutes, no code.

Outcome: every file uploaded to a folder you choose shows up in a To review collection automatically, so nothing new slips past your reviewers.

Who it's for: anyone with edit access to a drive who hasn't built an automation yet. This guide also covers the editor basics that the other automation recipes assume you know.

Time: about 10 minutes.

Before you start

  • Have edit access to the drive.

  • Create the collection the files should go into. In the left sidebar, open your drive, find Collections, and click +. Name it To review. See Creating Asset Collections.

  • Optional: skim Automations for the full list of triggers and actions.

How it works

Every automation is a trigger (the event that starts it) followed by one or more actions (what Shade does in response). This one has a single action:

Steps

1

Create the automation

In the left sidebar, open your drive and click Automations. Click New Automation, then click the name at the top and rename it to something that says what it does, such as New uploads → To review.

2

Choose the trigger

Pick File uploaded (listed as Asset Uploaded in the full trigger list).

Under Upload location, choose the folder to watch, for example Incoming. Turn on Include subfolders if files land in nested folders. Leave the location empty to watch the whole drive.

Watching a specific folder is usually better than watching the whole drive. It keeps exports, renders, and files created by other automations from setting this one off.

3

Add the action

Click + below the trigger and choose Add to Collection.

  • Collection: pick To review.

  • Asset: click the field, type {, and choose the uploaded asset from the trigger.

Typing { in any field lists values from earlier steps. You'll use these variables in every automation you build.

4

Save and activate

Click Save. If Save or Activate is greyed out, a step still has a required field empty. Hover over the button to see what's missing.

Then click Activate. New automations start as drafts and don't run until you activate them.

5

Test it

Upload a file to the watched folder. Within a few seconds it should appear in To review.

Open the automation and switch from Editor to Runs to see its run history. Each run lists every step and its output. If a run failed, the failed step shows the error.

Variations

  • Only certain file types: add a Filter step between the trigger and the action, so only videos (or only images) continue.

  • Different folders, different collections: use If / Else or Switch to route uploads from each folder into its own collection.

  • Tell someone too: add a Send Email step after Add to Collection to notify the reviewer.

  • Trigger on review instead of upload: use Asset Updated with a specific field and value, such as Status changing to Needs review.

Was this helpful?