Template Settings
- Media Gallery
- Controls
- Layout
Product Media Layout
Product Media Layout
Control media gallery layout style:
- Full (default) - Full-width media, max impact
- Partial - Partial width, more compact
- Media takes maximum available space
- Best for lifestyle imagery
- Visual impact priority
- Works well for fashion, home decor
- More compact media presentation
- Better balance with product info
- Good for technical products with detailed specs
Slides with Thumbnails
Slides with Thumbnails
Display thumbnail navigation for media gallery:
- None (default) - No thumbnails, arrows/dots only
- Desktop and Mobile - Thumbnails on all devices
- Only Mobile - Thumbnails on mobile, not desktop
Product Media Object Fit
Product Media Object Fit
How main product images scale:
- Cover (default) - Fill container, may crop
- Contain - Fit entire image, may show background
- No whitespace around images
- Consistent container size
- May crop edges
- Best for uniform image sizes
- Shows full image
- May show background color
- Preserves entire image
- Best for mixed aspect ratios
Thumbnail Object Fit
Thumbnail Object Fit
How thumbnail images scale:
- Cover - Fill thumbnail, may crop
- Contain (default) - Fit entire image in thumbnail
Adaptive Ratio & Auto Height
Adaptive Ratio & Auto Height
Control media gallery height behavior:
- Default - Fixed aspect ratio (set below)
- Adaptive Ratio - Height adapts to each image
- Slider Auto Height - Slider adjusts per slide
- Default: Consistent product image sizes
- Adaptive Ratio: Mixed aspect ratios, preserve original dimensions
- Slider Auto Height: Varying image heights in slideshow
Media Aspect Ratio
Media Aspect Ratio
Set fixed aspect ratio (visible when Adaptive Ratio = Default):
- Default - Theme default ratio
- 1:1 - Square
- 2:3 - Portrait
- 3:4 - Standard portrait
- 4:5 - Tall portrait
This setting only appears when “Adaptive Ratio & Auto Height” is set to “Default”.
Slider Background Transparent
Slider Background Transparent
Make slider background transparent:
- Type: Checkbox
- Default: Disabled (has background)
Blocks
- Core Blocks
- Purchase
- Content
@app Block
@app Block
Embed app blocks from installed Shopify apps.
- Review apps (Judge.me, Loox, Yotpo)
- Size chart apps
- Inventory apps
- Trust badge apps
- Customization apps
Apps must support app blocks. Drag and position where desired in product layout.
Title Block (Limit 1)
Title Block (Limit 1)
Display product title.
- Automatically pulls product name
- Rendered as H1 (SEO-optimized)
- No settings (automatic)
- Position anywhere in layout
Description Block (Limit 1)
Description Block (Limit 1)
Display product description with flexible behavior.Settings:Behaviour:
- Plain (default) - Standard text display
- Row (Accordion) - Collapsible accordion
- Tab - Tab interface
- Custom heading for description section
- Optional (leave blank to hide)
- Range: 0-5 lines (default: 3)
- Show “Read more” link if exceeds
- 0 = no truncation, show all
Text Block
Text Block
Add custom text anywhere in product layout.Settings:Text: Custom text contentText Style:
- Link - Styled as link/hyperlink
- Body - Standard body text
- None - No link
- Type - Links to product type page
- Vendor - Links to vendor/brand page
- Shipping information
- Return policy link
- Brand story
- Care instructions
- Certifications/badges
SKU Block (Limit 1)
SKU Block (Limit 1)
Display product SKU (Stock Keeping Unit).
- Automatically pulls from product variant
- Updates when variant changes
- Useful for B2B, technical products
- No settings (automatic)
Price Block (Limit 1)
Price Block (Limit 1)
Display product price.Settings:Show Price Extra Info:
- Type: Checkbox (default: enabled)
- Shows sale price, compare-at price
- Tax information
- Unit pricing (if applicable)
- Payment term preview
- Current price (large, prominent)
- Compare-at price (strikethrough if on sale)
- “Sale” or “On Sale” badge
- Price per unit (if configured)
Block Layout Strategy
Recommended Order
- Title - Product name (H1)
- Price - Pricing with sale info
- Variant Picker - Size, color selection
- Inventory Notice - Stock urgency
- Buy Buttons - Add to cart, dynamic checkout
- Description - Product details (accordion/tab)
- Content Tabs - Shipping, size guide, care
- Pickup Availability - In-store options
- Collapsible Content - Additional FAQs, specs
- @app - Reviews at bottom
Mobile Optimization
- Keep critical blocks above fold (title, price, buy button)
- Use accordions/tabs to reduce scroll
- Enable actions bar for sticky purchase
- Show tags on mobile for discovery
- Test actual devices for layout
Media Gallery Best Practices
Image Guidelines
Image Guidelines
Product Image Specs:
- Minimum resolution: 2048x2048px
- Aspect ratio: Consistent across all images (square or 3:4)
- File format: JPG (photos) or PNG (graphics/transparency)
- File size: Under 500KB each (compress)
- Quality: High-resolution for zoom feature
- Main product image (front view)
- Alternative angles (side, back, top)
- Detail shots (texture, materials, features)
- Lifestyle/use images (product in context)
- Size/scale reference
- Color variations (if applicable)
When to Use Thumbnails
When to Use Thumbnails
Enable Thumbnails When:
- 4+ product images
- Customers need quick navigation
- Visual merchandising priority
- Desktop browsing important
- 1-3 images only
- Mobile-first audience
- Minimal design aesthetic
- Page speed critical
Video & 3D Media
Video & 3D Media
Shopify Supports:
- YouTube/Vimeo embeds
- Direct video uploads
- 3D models (GLB format)
- 360-degree spin images
- Place video after 2-3 images (not first)
- Keep videos under 60 seconds
- Mute by default
- Provide play/pause controls
- 3D models for complex products
Variant Selection Best Practices
Variant Display Strategy
Variant Display Strategy
Buttons Layout:
- Best for: 2-8 options per type
- Examples: S, M, L, XL or Red, Blue, Green
- Visual, easy to scan
- Shows all options at glance
- Best for: 10+ options
- Examples: 20 sizes, many colors
- Saves space
- Searchable (type to find)
- Vertical button layout
- Good for image swatches
- Mobile-friendly
- Visual emphasis
Variant Images
Variant Images
Strategy:
- Assign variant-specific images in Shopify Admin
- Image updates when variant selected
- Show product in selected color
- Reduces confusion
- Upload images for each color variant
- In Shopify Admin → Products → [Product] → Media
- Click image → Select variant association
- Image auto-displays when variant chosen
Sold Out Handling
Sold Out Handling
Best Practices:Visual Indicators:
- Strike-through sold out options
- Gray out unavailable variants
- “Sold Out” label overlay
- Hide completely (not recommended - shows range)
- Enable “Back in Stock” in variant picker setting
- Collect customer emails
- Auto-notify when restocked
- Capture lost sales
Use Cases
Fashion Store
Buttons variant picker, 8 lifestyle images, size guide page, content tabs for materials/care
Electronics
Dropdowns for tech specs, video demo, detailed tabs (specs, warranty, support), SKU display
Subscription Product
Purchase options block, benefits tabs, inventory notice for urgency
Gift Card
Amount variants as buttons, gift recipient form enabled, minimal description
Handmade Goods
Artisan images, collapsible content for story/process, inventory notice (limited quantity)
B2B Wholesale
SKU prominent, quantity discounts in tabs, pickup availability for warehouse locations
Quick Summary
- Purpose: Individual product detail page template
- Layout: Flexible block-based (drag & drop blocks)
- Media: Advanced gallery with thumbnails, aspect ratios, object fit
- Core Blocks: Title, price, variants, description, buy buttons (limit 1 each)
- Content Blocks: Tabs (4 max), collapsibles (unlimited), custom liquid
- Features: Inventory notices, pickup availability, selling plans, dynamic checkout
- Customization: 14 block types, media controls, alignment, color schemes
- Settings: Media layout, thumbnails, object fit, actions bar, alignment
Product content (title, price, images, description, variants) is managed in Shopify Admin → Products. This template controls how that content displays, not the content itself.