Uploading Images Error message: file name must be ID of image setting

Topic summary

Main issue: On older Shopify themes (Responsive, Minimal), uploading slideshow/banner images throws “File name must be the ID of an image setting.” Screenshots show an “invalid setting ID” error.

Early attempts: Edits in settings_schema.json suggested changing type from “image” to “image_picker” and removing file extensions from IDs (e.g., use id “slide_1” not “slide_1.jpg”). Some mention of schema_data.json.

Updated solution (most effective): These themes rely on static asset names. Rename files to match expected IDs, e.g., “slideshow_1.jpg”, “feature1.jpg”, “logo.jpg”. In Theme > Edit code > Assets, delete/rename conflicts, then Add new asset and upload the correctly named file. Use code search for “.jpg”/“.png” to see required filenames.

Long‑term/advanced fix: Update theme settings to the newer JSON schema and replace static references like {{ slideshow_1.jpg | asset_url }} with dynamic settings like {{ settings.slideshow_1 | img_url }}. Alternatively, switch to the Dawn theme for better flexibility.

Status: Several users still report issues; helper offers collaborator access via Users & permissions (collaborator request code). Discussion remains open; no universal resolution confirmed.

Summarized with AI on December 28. AI used: gpt-5.

We need immediate help with this. Our sale started at midnight and we cannot update images for this. Customers are going to our store and cannot find the sale.