Error message when trying to upload image to homepage

Topic summary

Issue: Uploading a new homepage image throws an error saying the image “didn’t have an image number,” while the same image uploads fine to Files and displays on its product page.

Likely cause: The homepage section/block is using a legacy theme setting type “image” instead of “image_picker” (Shopify’s input that lets you select/upload images in the theme editor).

Proposed fixes:

  • Add a “Multi‑column” block in the theme editor, which includes an image_picker field for images.
  • In the theme code, search and replace “type”: “image” with “type”: “image_picker” in key files, e.g.:
    • Templates > product.liquid
    • Sections > product.liquid
    • Config > settings_schema.json

Notes: Screenshots were provided to show where the image_picker component appears in the editor. No code snippets are central beyond the type replacement.

Outcome/status: The original poster thanked respondents; no explicit confirmation of the exact fix applied, but guidance was accepted and the issue appears resolved.

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

For years I’ve uploaded a new image to my homepage every time I finish a new painting and add a new product page. Today I created the new product page and the new image to that page no problem, but when I went to upload it to the homepage, I kept getting an error that said the image didn’t have an image number. I checked whether the image had actually be uploaded to the file section, and it had and was displaying correctly on the product page. I came here and found that a number of people were having the same problem. The “solution” was “Please update your theme settings type image to image_picker”. I know enough html to make small adjustments in display on product pages, but I do not know where this theme settings for type image is and I have looked. Please just tell me how to find it and I will fix it.

Hi,

Maybe you can try to add a “multi-column” block.

This block includes an image_picker component.

If you have any questions or need further assistance, don’t hesitate to reach out.

Hello @HaroldARoth ,

try to check in these files:

  1. Templates > product.liquid
  2. Sections > product.liquid
  3. Config > settings_schema.json

You need to find this
“type”: “image”,

and replace it with
“type”: “image_picker”,

Thanks

Thank you!