Skip to Content
DocumentationGuidesProduct details containers

Product Details Containers

Use Product details containers when the product page needs more than one purchase-panel layout. The Product details section owns the media gallery and overlay system; Container blocks create the panels inside that system; product blocks create the actual buying and information flow.

Setup Order

  1. Start with Product detailsSet the section height, media behavior, overlay layout direction, overlay position, gap, blur, and uniform overlay sizing before tuning individual panels.
  2. Choose the container patternUse one purchase container for a compact buying card, or split content into separate containers when information and purchase controls should live apart.
  3. Group product blocks intentionallyKeep title, price, variants, buy buttons, size guide, disclosures, and app blocks in the container that matches the customer task.
  4. Tune container surfacesUse each Container block for width, padding, inside spacing, alignment, background, border, radius, and shadow.
  5. Preview mobileCheck long product titles, app blocks, variant controls, buy buttons, and disclosure rows on mobile before publishing.

Layer Ownership

LayerOwns
Product details sectionMedia gallery, section height, header accounting, overlay layout, overlay position, overlay gap, overlay blur, and uniform overlay size.
Container blocksProduct information panels, inside direction, alignment, gap, width, padding, surface color, border, radius, and shadow.
Product blocksTitle, price, variant picker, quantity, buy buttons, size guide, disclosures, stock status, product information, and app blocks.

Use section settings to place the panels. Use Container settings to shape each panel. Use product blocks to decide what customers can read, select, and buy.

Pattern 1: Split Overlay Containers

Fit Check theme editor showing Product details with one information container on the left and one purchase container on the right.
Split overlay containers separate product information from the purchase form while the Product details section positions both panels around the media gallery.

Use split containers when the product page needs a larger information panel and a separate focused buying panel. This works well for policy accordions, manufacturing notes, fit/care content, and a purchase panel that should stay visually distinct.

ContainerTypical contents
Information containerAccordion, tabs, product description, disclosure rows, fit notes, care notes, or custom content.
Purchase containerProduct title, price, variant picker, quantity, buy buttons, size guide, stock status, and app blocks.

Pattern 2: Centered Purchase Container

Fit Check theme editor showing Product details with a compact centered purchase container over the media gallery.
A centered purchase container keeps the buying controls compact while the media gallery remains the dominant visual surface.

Use a centered purchase container when the product media should frame the buying action and the product does not need a large side panel. Keep the container compact: title, price, variant picker, add-to-cart, and the most important supporting links.

Pattern 3: Side Purchase Container

Fit Check theme editor showing Product details with a side purchase container next to the product media.
A side purchase container keeps the product form near the media while leaving large product images as the main visual focus.

Use a side purchase container when the buying panel should be easy to scan without covering the main product media. It is also ideal when the page should showcase large product images first while still keeping the purchase form easy to find. This is usually the safest compact pattern for products with multiple sizes, swatches, or app blocks.

Container Guidance

DecisionRecommendation
One container or twoUse one container for a simple purchase card. Use two containers when disclosures, shipping, manufacturing, or fit content needs its own panel.
Overlay gapSet the minimum space between panels in the Product details section, then use each container’s gap setting for spacing inside the panel.
Horizontal referenceKeep Auto (recommended) for responsive composition: 2/3 width media uses the three-column grid, while one-, two-, and three-column media use section edges. Explicit Section edges and Three-column grid choices override Auto; Space between always uses section edges.
Uniform overlay sizeEnable it when multiple panels should feel intentionally matched. Leave it off when the information panel and purchase panel have different content density.
Container widthUse custom width for deliberate purchase-card sizing, but check mobile before publishing.
Container linksAvoid whole-container links in Product details because variant pickers, buy buttons, disclosure rows, and app blocks are already interactive.
Surface stylingUse background, border, radius, and shadow when a panel needs contrast over the media gallery.

Product Block Grouping

GoalRecommended block grouping
Fast purchaseTitle, price, variant picker, quantity, buy buttons.
Sizing confidenceVariant picker, sizing fit, size guide, product disclosures.
Editorial confidenceProduct description, accordion rows, tabs, product information, app blocks.
Compact mobile flowKeep the first visible container focused on price, variants, and add-to-cart; place longer supporting content after the buying controls.

Publish Checklist

StateWhat to confirm
Desktop overlayContainers do not cover important product media or header controls.
Multiple panelsProduct details overlay gap keeps panels separated without pushing them off screen.
MobileContainers stack in a readable order and controls remain tap-friendly.
Variant pickerSwatches, dropdowns, and sold-out states fit inside the chosen container width.
Buy buttonsAdd-to-cart and accelerated checkout remain visible and do not crowd size guide or app blocks.
DisclosuresAccordion rows open without overlapping the purchase container or media controls.