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.
| Image | Where | Upload at least | Shape |
|---|---|---|---|
| Product photos | Product gallery, product cards | 2400 px on the long side | Keep one shape per product, matching the Gallery block's Image shape |
| Fabric gallery photos | Product gallery, per fabric | 2400 px on the long side | Same shape as the product photos |
| Swatch image | Fabric picker, cart, product cards, library | 400 × 400 px | Square, a flat close-up of the cloth |
| Large image (fabric) | Fabric panel and library preview, zoom | 2000 px wide | Any; square or 4:3 works best |
| Fabric close-ups (Gallery field) | End of the product gallery | 2000 px wide | Same shape as the product photos |
| Room photo beside a room plan or room elevation | Home page, Drawing Room and Graphite product pages | 2000 px wide | Landscape (3:2) |
Your own drawing (custom.drawing) | Product page, full drawing | SVG, or a PNG 2000 px wide | Any |
| Hero, full width | Home page | 2800 px wide | Landscape |
| Hero, mobile image | Screens narrower than 750 px | 1500 px tall | Portrait |
| Collection images | Collection cards, collection banner | 2000 px wide | Matching the section's Image shape |
| Shop the room | Room photo | 2400 px wide | Landscape (3:2) |
| Logo | Header | Twice the Logo width setting | PNG or SVG with a transparent background |
| Favicon | Browser tabs | 180 × 180 px | Square 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.