The metafield lets you set a custom image for Sub Collections inside the collection template. This image is separate from the collection’s featured image used on the collection list page.
Which metafield do I need to create?
Name: Collection image
Metafield Key: theme.hero_image
Type: Image (File)
Where will this image appear?
It displays in the Collect
ion Banner section or in Image with Text sections.
It does not affect the featured image shown on the collection list/grid page.
What happens if I use this metafield?
If "theme.hero_image" has an image:
The theme will show the metafield image in Sub collections
It will override the default collection image for that section only
If it’s empty:
The theme will automatically fall back to the collection image set in the Collection manager, or the first product image in the collection (if no collection image is set).
Do I need to connect the metafield in the theme editor?
No. This metafield is auto-detected by the theme. Just upload the image into the metafield and it will work.
Use metafield "theme.hero_image" when you want different visuals for Sub collections without changing the main collection image used elsewhere.
