Product dossier
The reference drawer of the product page: the full ingredient list, warnings, size and storage, and sourcing, in grouped disclosures. Panels animate to their measured height on open and close, so the page does not snap. Up to 14 groups.
- Merchant-addable
- Yes
- Settings
- 40
- Block types
- 3
- Max blocks
- 14
- File
sections/product-dossier.liquid
Used by default on: Product, Product (set)
When to use it
Any product with dense reference facts that a careful buyer checks but most shoppers do not need open.
Setting it up
- Add the section to a product template.
- Write the heading under Content. Mobile header alignment centers the eyebrow, heading, and body text on phones, and the groups below stay left-aligned.
- The preset starts with four groups: Full ingredient list, Warnings, Size and storage, and Sourcing. Edit or remove them, or add a Dossier group block for any other reference topic.
- Add Proof point blocks for short factual callouts that do not need a full panel. Their headings and text always show in full, so keep them to a few words; side by side, the text rows stay level however far a heading wraps.
- For an ingredients or certifications group, set Value source on the block so the body fills from the product. Prose panels stay typed. See Per-product content.
Where the content comes from
Blocks own all panel content.
Notes and cautions
- Panels respect the global motion setting and fall back to an instant native toggle when motion is off or JavaScript is unavailable.
- The section shows one image: the product's featured image, or a custom image set under Image source. It does not repeat the product gallery, which already sits at the top of the page. Desktop image ratio sets the shape on tablets and desktop, and Mobile image ratio sets it on phones: Square by default so the groups start sooner, or Same as desktop, Portrait, or Landscape. Image fit applies everywhere. With Image source set to custom, an optional Mobile image replaces the image on phones, with its own focal point; phones download only that image. On phones the image sits between the heading and the groups. Turn off Show image on mobile to put the facts first below 990px wide. The hidden image is not downloaded, and the product link stays.
- The heading always sits above the groups, on whichever side Image position on desktop leaves for them. On desktop, the image stays pinned below the header while the groups scroll past, so opening a long group never leaves it behind. Media vertical alignment on desktop sets where it rests, and defaults to Top so the image lines up with the heading. On short screens, the pinned image trims slightly so all of it stays visible.
- Do not hide anything that affects the purchase decision behind a disclosure. Shipping cost belongs in the open.
- Keep to three or four groups, and only facts no other section on the page covers. The default product template already gives benefits and suitability, how to use, key ingredients, and test results their own sections (Benefits and suitability, Protocol timeline, Ingredient atlas, and Proof ledger), so repeating them here makes shoppers read everything twice. Add those topics as groups only when the dossier is used without those sections.
Custom values in information groups
Use a custom product metafield when the standard category attributes do not cover a value you want to display.
- Create a product metafield definition in Shopify admin, with a supported plain-value type.
- Fill the field on every product that should display it.
- In this section, open an information group and select Custom product metafield.
- Enter the definition’s full namespace and key, such as
custom.product_summary, in the newly shown metafield identifier field. Enter this as plain text, without a dynamic-source connection. - Save and preview products with different values. Existing manual fallbacks remain available.
See Custom product metafield setup for field creation steps, supported types, this section’s exact fallback behavior, and troubleshooting. If you enter only the key without its namespace, the theme editor displays a message explaining the required format.
Section settings
Every setting on the section itself, in the order it appears in the theme editor. Group headings match the editor's own grouping.
Content
Aligns the eyebrow, heading, and body text on screens below 750px.
Use for the featured image and the optional product link. On product pages, the current product supplies both.
Media
Applies below 990px wide, where the image sits between the heading and the groups. When hidden, the image is not downloaded and the product link stays.
Cropped to the image ratio set below.
Optional. Replaces the custom image on phones. Uses the custom image when left empty.
Sets where the image rests beside the groups. On desktop, it stays in view while the groups scroll past.
Style
Blocks
Blocks are added, reordered, duplicated, and removed inside the section. Each type has its own settings.
Group group max 10
Use a short phrase that helps shoppers understand the group before opening it.
Fills the body from the product, which suits an ingredients or certifications group. The typed content appears when the product has no value.
Enter the full product metafield identifier as plain text, such as custom.when_to_use. Reads each relevant product, including cards with their own product. Supports text, numbers, true/false, and lists of text or numbers. Missing or unsupported values keep the existing manual fallback or empty state.
Connect this setting to a product metafield to maintain different information for each product.
Appears when nothing else resolves, including when a dynamic source connected to the content is empty for a product. Leave blank to hide the group instead.
Optional. Name the study, certification, standard, or documentation behind the information.
Optional. Link to supporting documentation or a relevant page in the store.
@theme @theme
Added inside each Group, and reordered within it.
This section has no settings of its own.
Proof point proof max 3
Keep claims factual and remove any proof point that does not apply to the product.