Set up the "Show on model" feature

Show on Model metafield structure

Maison expects the following product metafield:

Field name: Model media
Namespace and key: theme.model_media
Data type: Document
Value type: Single value
Content used by Maison: Image

Maison reads the metafield from the theme namespace and checks the model_media value.

The theme only displays the alternative media when its media type is:

image

For this reason, use an image rather than another document or media type.

Show on Model behavior

• Show on model is designed for product cards.
• The feature is available in the main collection product grid.
• The feature is also available in search results.
• The feature uses the product metafield theme.model_media.
• Each product can have a different model image.
• Products without a model image remain on their regular product image.
• The model image uses the same product-card aspect ratio as the regular image.
• The model image uses the same image-fit setting as the regular product card image.
• The customer switches the entire product grid between model view and product view.
• The Show on model control changes to Product view while model view is active.

Remembering the customer's view

Maison remembers the customer's selected view in supported browsers.

For example, if a customer selects Show on model, Maison can preserve that selection when the customer navigates between supported collection or search pages.

When the customer selects Product view, the preference is updated again.

The remembered preference depends on browser storage being available.

Interaction with the secondary product image

Maison can also display a secondary product image when the product card is hovered.

The model image is a separate image from the normal featured image and secondary image.

When model view is active, the image stored in theme.model_media is displayed as the product-card model image.

You do not need to replace or remove the normal featured or secondary product images to use Show on model.

Where Show on Model is available

In this version of Maison, the Show on model switch is built into:

• Collection product grids
• Search results

The setting is not a global Theme setting.

It must be enabled in each applicable collection template and separately in the Search results block.

The feature is not used as a model-image switch on the main product detail page.

Troubleshooting

If the Show on model control does not appear on a collection page, open that collection template and make sure Show on model is enabled in the main product-list section.

If the control does not appear on the search page, open the Search template, select the Results block, and enable Show on model.

If the control appears but a product image does not change, make sure that product has a value assigned to:

theme.model_media

If the metafield does not appear on the product page, make sure the metafield definition was created under the Product module.

If the model image still does not appear, make sure the metafield contains an image. Maison does not display another media type through this feature.

If the model image looks incorrectly cropped, check the product card Aspect ratio and Image fit settings. The model image uses the same settings as the normal product image.

If some products switch to model images while others do not, check the theme.model_media metafield individually for the products that remain unchanged.

If the feature appears on one collection template but not another, enable Show on model separately on the missing collection template.

If the storefront opens in model view even though the customer did not just select it on that page, the browser may have remembered the customer's previous Show on model preference.

Need Further Assistance

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