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.

Are you comfortable adding me as a staff, or having me request developer code? I can request it and you’ll see my invite to the store owner email. I’ll just need your url and invite code if applicable.