Live, limited P1

Use per-image JSON sidecars

Apply advanced copy and destination overrides to one matching artwork without changing the rest of a batch.

Availability
Live, limited
Last verified
Runtime anchor
ab084f79c5ed3fc6a28f07c64b29920944a0e5db
Certification anchor
db23559179dc3c67be8a1ab16a0f07323b9820f7
Evidence note
Parser precedence, filename safety, and fail-closed routing were contract-verified. The file picker discoverability gap remains.

What this does

Apply advanced copy and destination overrides to one matching artwork without changing the rest of a batch.

Before you begin

  • Use a valid JSON object, a safe filename, and the same stem as the target artwork.
  • Prefer CSV/XLSX for ordinary bulk editing; sidecars are an advanced control.

What changes outside ArtDrop

A sidecar is local routing/copy input until the image is processed. In a normal drop, its store, line, and copy values can direct real external publication.

Steps

  1. Name the pair

    For artwork-name.png, create artwork-name.json. Keep both names under the safe filename ceiling and do not include paths.

  2. Set only supported keys

    Use the documented copy fields and optional store/line values. Do not place credentials, tokens, arbitrary URLs, or executable content in the file.

  3. Understand precedence

    For the matching image, sidecar values override conflicting spreadsheet values. Missing fields can still come from the sheet or configured defaults.

  4. Drop the pair

    Drag the image and JSON together. The browser picker does not currently advertise .json, so drag-and-drop is the clearest supported UI path.

Expected result

The image is processed once with its sidecar values and an exact, validated destination stamp.

Limits and non-goals

  • Each JSON sidecar is limited to 2 MiB.
  • Unsupported or unknown routing values fail closed.

Troubleshooting

  • For invalid JSON, validate syntax and UTF-8 encoding before retrying.
  • If the sidecar is ignored, compare the exact filename stem and use drag-and-drop.

How to undo or clean up

Remove or correct the sidecar before a new drop. It cannot undo an external product created by an earlier run.