Even the most perfect workflows can occasionally run into roadblocks, usually due to missing files or logic gaps. Here is how to resolve the most common issues you might encounter while using ezActions.
Visual Warnings on the Canvas
- Nodes outlined in Red: Before a workflow runs, ezActions performs a “preflight check”. If a node turns red, it means a mandatory setting is missing. Click the red node and ensure all required fields are filled out (e.g., a missing folder path in a Save Document node, or an empty value in an If Condition node).
- “⚠️ File missing!” or “⚠️ Folder missing!”: This warning appears inside a Select File or For Each node if the asset it points to was moved, renamed, or deleted from your computer. Simply click the button on the node to re-link the correct path on your hard drive.
Execution Errors (Status Bar)
- “No file context found”: This error occurs when a node (like Open Document or Place Image) expects a file to work with, but the preceding sequence didn’t provide one. Ensure you have a Select File or For Each (set to “File”) node correctly connected before this step.
- “No active document”: A node (like Resize, Align, or Save) is trying to modify an image, but Photoshop currently has no documents open. Make sure an Open Document node is included and successfully executed earlier in your chain.
- “Action failed: [Name]”: If a native Photoshop Action fails during an Actions node execution, it is almost always because the Action contains embedded “Open” or “Save” commands that conflict with the automation loop. You must open your Photoshop Actions panel, duplicate the action, and delete any “Open” or “Save” steps from it.
- “Unsupported format or corrupted”: Photoshop was unable to open the file passed to the Open Document node. Ensure the targeted folder only contains supported image formats and no hidden system files.
General Plugin Issues
- Version Mismatch Warning: If you try to open a workflow that was created in a newer version of ezActions, a warning modal will appear. You can choose to open it anyway, but some newer nodes or settings might not function correctly until you update the plugin.
- UI rendering issues or disconnected cables: If the canvas behaves strangely or connection cables appear misaligned, click the “Cleanup Layout” (broom icon) in the top toolbar to automatically reorganize and fix the visual connections of your nodes.