Treez Ecommerce uses a flexible fallback system to assign stock images to products that do not have custom photos in SellTreez. This logic ensures your storefront and kiosk display visually consistent and relevant imagery—especially for categories where generic images may cause confusion (for example, prerolls shown with a flower image).
This guide explains:
How stock image assignment logic works
Where to update stock images in Prismic
How to correctly configure image mappings
Note: We've recently added significantly more stock images and associated type:subType configurations to support broader product coverage.
If you are currently live, and would like to update your stock images, please reach out to [email protected].
Stock Image Assignment Logic
When a product lacks a custom image, SellTreez applies the following logic based on image mappings in Prismic CMS:
1. Primary Match: Type and SubType Combination
If a stock image exists for the exact type:subType combination, that image will be used.
Example: A product with type = Preroll and subType = Flower will use the image labeled Preroll:Flower.
2. Fallback 1: Type Only (When No SubType Is Defined)
If a product has no subType configured, the image assigned to its type will be used.
Example: A product with type = Tincture and no subType will use the image labeled Tincture.
3. Fallback 2: Type Only (When Type:SubType Is Not Defined in Prismic)
If a product has both type and subType, but no matching image is defined in Prismic, the image for the type alone will be used.
Example: A Preroll:Hybrid product without a Preroll:Hybrid image will fall back to the Preroll image.
Extensibility
You can upload new images for any type:subType combination directly in Prismic. No code changes or developer support is needed.
How to Update Stock Images in Prismic
Stock images are managed in the Product document in Prismic CMS, under the Stock Image tab.
Steps to Configure or Update a Stock Image
Open Prismic and navigate to the Product document.
Click the Stock Image tab.
To add or edit a stock image mapping:
Enter the image key in the Name field using the format
Type:SubType.Examples:
Merch:lighter,Preroll:Flower
Upload the Default Product Image (recommended size: 1000x1000px).
Enter a short and descriptive Alt text for accessibility.
Click Save, then Publish the document.
Trigger a Theme Refresh
After publishing changes in Prismic, follow these steps to make sure your updates appear live on the site:
Go to the Main Page of your Prismic repo.
Click Settings.
Click Webhooks.
Toggle the Update Theme status to ON.
Click Trigger It.
Toggle the Update Theme status back to OFF.
Your site will begin publishing. This process typically takes 5–10 minutes. Once complete, you should see updated stock images live on the storefront and kiosk.
Best Practices
Ensure that
typeandsubTypevalues exactly match product definitions in SellTreez.Preview your site on both storefront and kiosk after updates to verify image rendering.