Troubleshoot product and collection pages
Fix Borders product and collection pages: swatches that do not show, cropped images, missing banners, filters and badges.
Applies to: Borders 3.1.0 and later. Added in: Borders 1.0.0. Last checked: 2026-10-13 against Borders 3.1.0.
Answers to the most common questions about product pages, product cards and collection pages in Borders. The settings are explained on the Product page, Collection page and Product card theme settings pages.
Why are my color options not swatches?
The option name is not in the swatch list, or swatches are off. In Theme settings → Color swatches, turn on Show color swatches and check that your option name is in Color swatches option names, in lowercase (for example color or farbe). Then each value needs a color: a CSS color name (Red, Navy), a Shopify category metafield swatch, or an image file named after the value in Shopify admin → Content → Files. See Color swatches theme settings.
Why are my product images cropped?
Borders shows all product images in one aspect ratio, so images with another shape are cropped. Set the ratio closest to your photos: Theme settings → Product card → Media aspect ratio for product cards, and Media aspect ratio in the Product page section for the gallery. To show whole images without cropping, turn on Fit media inside container in the same places.
Why does my collection banner not show?
Show collection image is off in the Collection page section, or the collection has no image. Turn it on, and add an image to the collection in Shopify admin → Products → Collections. With Hide on mobile devices on, the banner is also hidden on phones.
Why do filters not show?
Enable filtering is off in the Collection page section (or Search results section), or there are no filters set up. Filters are created in the Shopify Search & Discovery app: Filters → Add filter. A collection without products shows no filters.
Why does my discount badge say "On Sale" instead of a percentage?
The product's variants have different prices or compare-at prices. Product cards then show the generic "On Sale" text instead of one saving (the editor note calls it "Sale"). The Product badges block on the product page shows the badge of the selected variant.
Why does my custom badge not show?
The product does not have the exact tag of the badge. In Theme settings → Product card → Custom badge, the Tag must match a product tag letter for letter, for example new. Add the tag to the product in Shopify admin → Products.
Why does the size guide not show on a product?
The product has no option whose name is in Size guide option names of the Variant picker block, or no Size guide page is chosen. Check the option name, in lowercase, and the page. See Setting up a size guide.
Why do my reviews not show on product cards?
Theme settings → Product card → Rating app is not set to your review app, or Rating display (desktop) is Don't show. The app must also write its ratings to the product, which some apps do only after the first reviews.
Related pages
- Product page: gallery and product blocks.
- Collection page: banner, grid, filters and promo cards.
- Product card theme settings: media, badges, quick buy and ratings.
- Color swatches theme settings: swatches for color options.
Troubleshoot popups and overlays
Fix Borders popups: newsletter popups and popovers that do not show again, the cookies popover, age verification and the exit intent popup.
What Borders does not do
The limits of Borders in one place: what the theme does not support, and what to use instead, from free shipping per market to payment icons.