Documentation menu

Performance and images

Treadle is built to stay fast with large catalogs: a sofa with 40 fabrics and 240 variants loads its fabric panel, zoom images and sample code only when a shopper uses them, and below-the-fold sections load as the shopper scrolls. The drawings are drawn on the server as inline SVG, so they need no image downloads and no script to appear. Most slow stores are slow because of large images and apps. This page covers both.

Image sizes #

Shopify resizes and converts every image you upload, so the file you upload is the largest size a shopper can get. Upload at least the size below, and not much more.

ImageWhereUpload at leastShape
Product photosProduct gallery, product cards2400 px on the long sideKeep one shape per product, matching the Gallery block's Image shape
Fabric gallery photosProduct gallery, per fabric2400 px on the long sideSame shape as the product photos
Swatch imageFabric picker, cart, product cards, library400 × 400 pxSquare, a flat close-up of the cloth
Large image (fabric)Fabric panel and library preview, zoom2000 px wideAny; square or 4:3 works best
Fabric close-ups (Gallery field)End of the product gallery2000 px wideSame shape as the product photos
Room photo beside a room plan or room elevationHome page, Drawing Room and Graphite product pages2000 px wideLandscape (3:2)
Your own drawing (custom.drawing)Product page, full drawingSVG, or a PNG 2000 px wideAny
Hero, full widthHome page2800 px wideLandscape
Hero, mobile imageScreens narrower than 750 px1500 px tallPortrait
Collection imagesCollection cards, collection banner2000 px wideMatching the section's Image shape
Shop the roomRoom photo2400 px wideLandscape (3:2)
LogoHeaderTwice the Logo width settingPNG or SVG with a transparent background
FaviconBrowser tabs180 × 180 pxSquare PNG

File tips:

  • Save photos as JPEG at about 80% quality, or WebP. A 2400 px product photo should be under 500 KB.
  • Use PNG only for logos and images with transparency. A PNG photo can be ten times larger.
  • Don't upload the same photo twice at different sizes. Shopify makes the smaller sizes itself.

Alt text #

Alt text describes an image to people using screen readers and to search engines.

  • Product and fabric gallery photos: describe what's in the photo, for example "Harlow sofa in Forest Velvet, three-quarter view". Edit it in Content > Files or in the product's media.
  • Swatches: Treadle uses the fabric name, so you don't need alt text on swatch images.
  • Sections with an Image description setting use that text, or the image's own alt text when the setting is empty.
  • Decorative images, such as a texture behind a heading, can stay empty.

Settings that affect speed #

  • Hero: put the hero first on the page. Treadle loads the first hero image before anything else.
  • Video section: Play muted in a loop when in view downloads the video as soon as the section is near the screen. Leave it off unless the video matters more than the speed.
  • Fabric library > Fabrics loaded at a time: with several hundred fabrics, 100 or 150 makes the first view lighter. The rest loads right after.
  • Featured collection > Layout: Grid loads no extra code. Carousel loads a small script.
  • Product cards > Show the second image on hover: loads a second image per card on desktop only. Turn it off on very long collection pages if you see slow scrolling.
  • Keep the number of sections above the fold small. Everything after the first screen loads when shoppers scroll to it.
  • Drawings: each drawing adds a few kilobytes of SVG to the page. A Lineup hero of 24 pieces, a collection of 48 products in the To scale view or a long drawn row adds up. Keep lineups to about 12 to 16 pieces and collections to 18 to 24 products per page.
  • Silhouette library and Shape check: these pages draw hundreds of views and are slow on purpose. Keep them hidden from shoppers.

Apps and custom code #

  • Each app with storefront code adds scripts to every page. Remove apps you no longer use, and check under Online Store > Themes > ... > Edit code that their leftover snippets are gone. Ask the app developer if you aren't sure.
  • Treadle doesn't need apps for fabrics, samples, lead times or product groups. If you used apps for these before, remove them after setting up Treadle.
  • Custom Liquid sections and blocks run on every view of the page they're on. Keep them short.

Fabric and variant limits #

  • One product can list up to 250 fabrics in its fabric list. More than that won't show in the picker.
  • Keep each product at 250 variants or fewer, with at most 3 options. The product page works with more, but cards, lineups and To scale rows only see a product's first 250 variants, so their price and size could be wrong. See plan your variants.
  • Combinations that don't exist as variants give their reason, such as "Not made in leather". You don't need to create every combination.

Check your speed #

  • Shopify's web performance report shows your store's speed, based on real visits. Find it under Analytics > Reports, or search the admin for "web performance".
  • PageSpeed Insights tests one page. Test your home page, a collection and your largest product. Scores vary between runs, so run each test three times and look at the middle result.
  • To test an unpublished theme, click ... > Preview next to it, copy the preview link, and test that link.