Photoshop / Troubleshooting

Photoshop Smart Object is not directly editable: choose where to make the change

Use Edit Contents, a separate retouching layer, or a mask according to the edit you need, while preserving the reusable source.

Documentation reviewed · Not hands-on tested
Quick answer

If Photoshop rejects a brush or cloning operation on a Smart Object, do not rasterize it immediately. Open its contents when the underlying artwork must change. Use a separate layer for retouching around it, or a mask when you only need to hide part of the object.

In this guide
Applies to

Photoshop desktop on Windows and macOS. Applies to Smart Object pixel-editing restrictions, not Photoshop Elements, web/iPad workflows, general layer locks, or missing linked-source repair. Menu paths follow current Adobe desktop documentation.

Decide whether you need to change the source or the composition

Save a separate working document before changing reusable artwork. A template may use the same source in several places, so first decide whether your correction should appear everywhere or only in this composition.

Match the operation to the right location

Intended changeSuitable starting point
Edit artwork inside the placed objectEdit Contents
Add retouching above the objectA separate pixel layer with suitable sampling
Hide part of the objectA layer mask
Move or resize the placed objectTransform the Smart Object itself

Adobe's Smart Object overview explains why painting, dodging, burning, and cloning cannot operate directly on its stored pixels in the usual way. That restriction preserves a different editing workflow; it does not establish that the file is corrupt.

Edit the source deliberately

  1. Open Window > Layers and select the intended Smart Object layer.
  2. Choose Layer > Smart Objects > Edit Contents.
  3. Inspect the source file that opens before editing. Its application depends on the format; Illustrator artwork may open in Illustrator.
  4. Save the source, then return to the containing Photoshop document and inspect the result.

This is Adobe's Edit Contents workflow. Saving updates the corresponding object instances. For linked objects, the source is an external file that other documents can reference. Preserve that external file too; duplicating only the containing PSD is not a backup of every linked asset.

Before saving, check whether you are changing a shared logo, client master, or another asset intended to stay identical elsewhere. If the change belongs only to one layout, use a composition-level approach rather than overwriting the shared master.

Retouch without replacing the original

Adobe's nondestructive editing guidance describes retouching on a separate layer. Tools such as Clone Stamp and Healing Brush can sample underlying content when their sampling options are configured appropriately. Check the tool's available sampling controls rather than painting on an empty layer and assuming the tool is broken.

For a small blemish, make one localized change and toggle the retouching layer to compare. For an unwanted edge, consider a layer mask instead: it hides pixels while keeping the source available. These are editing choices, not automatic fixes for every template.

If Edit Contents does not solve it

Record the selected layer type, the exact message, the source format, and whether the source opens in another application. A locked ordinary layer or missing linked file needs a different diagnosis. Consult Adobe's Photoshop documentation and its support links with a sanitized example.

We have not tested this workflow in Photoshop. If your task is importing separate photographs before editing, see loading images as layers.

Sources and review date

Official documentation consulted on 2026-09-21. Diagnostic suggestions are editorial guidance, not a promise of a particular result.

A step no longer matches your app? Report a correction with the guide URL and version you use.

Related fixes