Handling Small Thumbnail Variants in Shopkeeper Product Cards

Catalog cards often expose a gap between “main image logic” and “small thumbnail logic”. The original Shopkeeper issue behind this article came from exactly that mismatch.

Typical Symptoms

• the small image variant uses a different path or rule set
• the product card and the full page disagree about the correct source
• template assumptions are hidden in several places at once

The strongest fix is usually not another conditional in the card template. It is a clear image strategy: one source of truth for the product image and one predictable rule for how the thumbnail is derived.

As soon as image handling becomes ad-hoc, catalog templates get harder to scale.