
A Photopea PSD can retain its Variables and Data Sets settings without retaining the Source images used for pixel replacement. Load those source files again before each variables export. Reopening the template with its table intact does not establish that the replacement photographs are available for another batch.
Separate the table from the replacement files
Photopea variables can control layer visibility, text content and pixel content. A CSV supplies values for those variables. For pixel replacement, a value identifies an image filename; it is not the image data itself.
Photopea's Variables documentation describes three parts under Image > Variables: Variables, Data Sets and Export as. It also states that the PSD stores the first two settings without the Source images. This persistence boundary is the issue here. A wrong column heading is a different problem, covered separately in the variable-header and template mismatch guide for Photoshop.
Reload the image inputs in the reopened template
For a hypothetical set of exhibition cards, suppose the CSV holds a speaker name and the filename of that speaker's approved portrait. Use a copy of the template and the approved source folder.
- Open Image > Variables and inspect the intended layer-to-variable assignments.
- In Data Sets, confirm the intended CSV is loaded.
- Choose Source images and select the replacement image files from your device.
- Compare the actual filenames with the values in the CSV, including their extensions.
- In Export as, select the required format and parameters, then export the resulting archive.
The portrait appearing in the template's current preview is not proof that every row's replacement file was loaded. Include rows with visibly different portraits in the acceptance check.
Diagnose a missing replacement without rebuilding the entire template
If the text changes but a portrait does not, check the source-image selection and filename relationship first. If neither text nor image values follow the table, inspect the loaded data and variable bindings instead. These observations guide investigation; they do not prove a specific cause on their own.
Do not claim that saving the PSD again will embed the full replacement-image library. The documented requirement is to load Source images before each export. Keep the image inputs and the CSV as explicit companions to the template, using portable source filenames and paths where a project changes computers.
Check a reopened session, not just the first successful batch
Inspect the exported files for correct name-to-portrait pairing, intended visibility and complete text. Retain the PSD, the actual CSV revision and the required source images. Then perform a small reopen-and-export exercise with those same inputs, reselecting Source images as documented.
For batch release discipline, the data-set export guide describes why preserving the template and distinguishing output files matters. Apply that general distinction without borrowing unsupported Photoshop commands into Photopea.
Related tasks
- Why Does My Photoshop Batch Action Save Files Under the Same Name?
- Apply Data Set or Export Data Sets as Files? Preserve Your Photoshop Template
- Why Does My Artwork Package Work Here but Fail on the Recipient’s File Path?
Sources and scope
- Photopea - Variables: Variables settings are stored in the PSD, but Source images must be selected again before each export.
Based on official Photopea documentation read on October 23, 2026 (Asia/Shanghai). The examples and acceptance procedures are proposed editorial guidance, not hands-on software tests. Browser support and current controls should be verified in the intended environment.
Prepared by Imagild Editorial, the company editorial team responsible for these guides. AI assisted research and drafting. This is documentation-based guidance with proposed examples, not a claim of hands-on testing or an independent product review. Report a correction.
Cover: Mak Cézar / Pexels, Pexels License. This is an illustrative source photograph, not an application screenshot or a generated test result.