Photoshop Smart Object Link Updater

Smart Object link updater icon: a parent PSD file with arrows pointing to two child PSDs and one PNG marked with a red error X, a visual of a broken external reference.

I built a Photoshop script that audits and updates smart object links across large Photoshop files.

The problem

Any art studio managing a large-scale asset pipeline knows this one. Smart objects in Photoshop reference external files. When those files move, renamed folders, reorganized projects, asset migrations, every linked smart object across every file needs to be redirected to the new location. Doing this by hand at production scale is slow, error-prone, and the kind of work nobody wants to be assigned.

The script

The script walks a Photoshop file and inventories every layer that holds a linked smart object, where it sits in the layer hierarchy, what file it points at, and whether that link still resolves. The output is a sortable log that can be exported to CSV for auditing, with a filter to surface only the missing links.

Layer Log dialog (with Linked Smart Object Paths): a list of all 281 layers in claude ui 02.psd, columns for hierarchy / type (Smart Object, Solid Fill, Group, Text) / Linked SO status / target file (icon_code.psb, icon_cowork.psb, iconchat.psb). Buttons at the bottom: Find Missing Links, Save CSV, Refresh, Close.

From there, missing links can be retargeted in batch, map old paths to new paths, run the rewrite, save. The native Photoshop workflow for this case was unreliable at scale; the script makes it predictable, with a record of what changed.

Why I built it

I was watching production teams burn hours on a problem that didn’t need to involve a human. The fix was small in scope but large in cumulative time saved. That’s the kind of utility I tend to build when nobody else is going to.