Setup Show On Model Feature

3. Enable Show on Model on Collection Pages

After adding model media to products, enable the Show on model option in the collection template.

1. From your Shopify admin, go to Online Store > Themes.
2. Find the Concept theme and click Customize.
3. Open the collection template, such as Default collection.
4. Select the Product grid section.
5. Enable Show on model.
6. Click Save.

Once enabled, the Show on model button will appear in the collection page top bar.

When customers click this button, product cards with a value in theme.model_media will switch from the default product image to the assigned model media.

Recommended setup:

Setting	Value
Template	Collection template, such as Default collection
Section	Product grid
Show on model	Enabled

4. Enable Show on Model on Search Result Pages

The same feature is also available on the search result page.

1. From your Shopify admin, go to Online Store > Themes.
2. Find the Concept theme and click Customize.
3. Open the Search template.
4. Select the Search results section.
5. Enable Show on model.
6. Click Save.

Once enabled, the Show on model button will appear on the search result page when the search results include products.

Recommended setup:

Setting	Value
Template	Search
Section	Search results
Show on model	Enabled

5. Preview the Show on Model Feature

After completing the setup, open a collection page or search result page on your storefront.

The page should display a Show on model button in the product grid top bar.

Check the following:

• The Show on model button appears on the collection page or search result page.
• Clicking Show on model switches product cards to model view.
• Products with a value in theme.model_media display the assigned model image or video.
• Products without a value in theme.model_media continue to display the default product image.
• The button text changes to Product view when model view is active.
• Clicking Product view switches the product cards back to the normal product image view.

Expected behavior:

Action	Result
Customer clicks Show on model	Product cards switch to the model media view.
Customer clicks Product view	Product cards switch back to the default product image view.
Product has theme.model_media	The assigned image or video is shown in model view.
Product does not have theme.model_media	The normal product image remains visible.

6. Notes and Limitations

Please note the following behavior:

• This feature works on product cards in collection and search result pages.
• It does not replace the product's featured image in Shopify admin.
• It does not change product images on the product page.
• Each product must have its own theme.model_media metafield value if you want it to show model media.
• Products without model media will keep showing the default product card image.
• The model view can display images or videos, depending on the file selected in the metafield.
• For the best result, use media with a similar aspect ratio to your product card image ratio.
• Very large videos may affect collection page performance.
• The Show on model option must be enabled separately on collection and search templates.
• The metafield namespace and key must be exactly theme.model_media.

Developer reference:

File	Purpose
sections/main-collection.liquid	Adds the Show on model setting and button on collection pages.
sections/main-search.liquid	Adds the Show on model setting and button on search result pages.
snippets/product-card.liquid	Reads product.metafields.theme.model_media.value and renders the model media on the product card.
assets/collection.js	Handles the model view toggle and remembers the selected view in local storage.
assets/collection.css	Shows or hides the model media when model view is active.

The product card only renders model media when both conditions are met:

{%- if show_on_model and product.metafields.theme.model_media.value != blank -%}

This means:

1. The Show on model setting must be enabled in the section.
2. The product must have a value in the theme.model_media metafield.

Troubleshooting

If the Show on model feature does not display correctly, please check the following:

• Make sure the Model media metafield has been created under Products.
• Make sure the namespace and key are exactly theme.model_media.
• Make sure the metafield type is File.
• Make sure the accepted file types are Images and videos.
• Make sure the metafield is set to One file, not a list of files.
• Make sure each product has a valid image or video selected in the Model media metafield.
• Make sure Show on model is enabled in the Product grid section for collection pages.
• Make sure Show on model is enabled in the Search results section for the search page.
• If the button appears but a product image does not change, check whether that product has a theme.model_media value.
• If the image is cropped or does not align well, use a model image with a similar ratio to the product card image ratio.
• If a video does not display as expected, try using a smaller Shopify-hosted video file.
• Clear your browser cache and refresh the storefront.
• Make sure you are using the latest version of the Concept theme.

Need Further Assistance

If you encounter any issues or need additional help with your Concept theme, please reach out to our support team via our Ticket System for assistance within 8 hours.