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

  1. Add the section to a product template.
  2. Write the heading under Content. Mobile header alignment centers the eyebrow, heading, and body text on phones, and the groups below stay left-aligned.
  3. 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.
  4. 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.
  5. 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.

  1. Create a product metafield definition in Shopify admin, with a supported plain-value type.
  2. Fill the field on every product that should display it.
  3. In this section, open an information group and select Custom product metafield.
  4. 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.
  5. 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.

Product dossier design

100%

Use the zoom controls, then scroll to inspect the image. Press Escape to close.

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

EyebrowText
ID
eyebrow
Default
Formula intelligence
HeadingText
ID
heading
Default
Product dossier
Heading sizeDropdown
ID
heading_size
Default
Medium
  • Smallsmall
  • Mediummedium
  • Largelarge
Body textRich text
ID
introduction
Default
<p>A clear account of the formula, its purpose, and the standards behind it.</p>
Mobile header alignmentDropdown

Aligns the eyebrow, heading, and body text on screens below 750px.

ID
mobile_header_alignment
Default
Left
  • Leftleft
  • Centercenter
ProductProduct

Use for the featured image and the optional product link. On product pages, the current product supplies both.

ID
fallback_product
Open the first group by defaultCheckbox
ID
open_first
Default
On
Show product linkCheckbox
ID
show_product_link
Default
On
Product link labelText
ID
product_link_label
Default
View product
Shown when
show_product_link

Media

Show mediaCheckbox
ID
show_media
Default
On
Show image on mobileCheckbox

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.

ID
show_media_mobile
Default
On
Shown when
show_media
Image sourceDropdown
ID
folio_source
Default
Product featured image
Shown when
show_media
  • Product featured imageproduct
  • Custom imagecustom
ImageImage

Cropped to the image ratio set below.

ID
image
Shown when
show_media and folio_source is 'custom'
Mobile imageImage

Optional. Replaces the custom image on phones. Uses the custom image when left empty.

ID
mobile_image
Shown when
show_media and show_media_mobile and folio_source is 'custom'
Image badgeText
ID
media_label
Default
Formula profile
Shown when
show_media
Image captionText
ID
image_caption
Default
The formula behind the facts listed here.
Shown when
show_media
Image position on desktopDropdown
ID
image_position
Default
Left
Shown when
show_media
  • Leftleft
  • Rightright
Media vertical alignment on desktopDropdown

Sets where the image rests beside the groups. On desktop, it stays in view while the groups scroll past.

ID
media_vertical_alignment
Default
Top
Shown when
show_media
  • Toptop
  • Centercenter
  • Bottombottom
Image width on desktopSlider
ID
desktop_media_width
Default
46
Range
38% to 54%, in steps of 2%
Shown when
show_media
Desktop image ratioDropdown
ID
image_ratio
Default
Portrait
Shown when
show_media
  • Portraitportrait
  • Squaresquare
  • Landscapelandscape
Mobile image ratioDropdown
ID
mobile_image_ratio
Default
Square
Shown when
show_media and show_media_mobile
  • Same as desktopsame
  • Portraitportrait
  • Squaresquare
  • Landscapelandscape
Image fitDropdown
ID
image_fit
Default
Cover
Shown when
show_media
  • Covercover
  • Containcontain
Use custom corner radiusCheckbox
ID
use_custom_image_radius
Default
Off
Shown when
show_media
Image corner radiusSlider
ID
image_corner_radius
Default
0
Range
0px to 32px, in steps of 2px
Shown when
show_media and use_custom_image_radius

Style

Color schemeColor scheme
ID
color_scheme
Default
scheme-6
Top paddingSlider
ID
padding_top
Default
80
Range
0px to 120px, in steps of 4px
Bottom paddingSlider
ID
padding_bottom
Default
80
Range
0px to 120px, in steps of 4px

Blocks

Blocks are added, reordered, duplicated, and removed inside the section. Each type has its own settings.

Group group max 10

IconDropdown
ID
icon
Default
Ingredients
  • Nonenone
  • Ingredientsformula
  • Benefitsbenefits
  • Suitabilitysuitability
  • Testingtesting
  • Warningswarning
  • Usageusage
  • Sourcingsourcing
HeadingText
ID
heading
Default
Ingredients
Scan textText

Use a short phrase that helps shoppers understand the group before opening it.

ID
summary
Default
What is inside and why it is here
Value sourceDropdown

Fills the body from the product, which suits an ingredients or certifications group. The typed content appears when the product has no value.

ID
attribute
Default
Manual value (same on every product)
  • Custom product metafieldcustom_metafield
  • Manual value (same on every product)manual
  • Certifications and standardsproduct-certifications-standards
  • Active ingredientsactive-ingredient
  • Constitutive ingredientsconstitutive-ingredients
  • Ingredient originingredient-origin
  • Skin typesuitable-for-skin-type
  • Skin care effectskin-care-effect
  • Skin care featuresskin-care-features
  • Product formproduct-form
  • Texturetexture
  • pH levelph-level
  • SPF levelspf-level
Metafield namespace and keyText

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.

ID
custom_metafield
Shown when
attribute is 'custom_metafield'
DetailsRich text

Connect this setting to a product metafield to maintain different information for each product.

ID
content
Default
<p>Niacinamide and panthenol lead this formula, with glycerin for a lightweight, comfortable feel.</p>
Fallback contentRich text

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.

ID
fallback_content
Evidence noteText

Optional. Name the study, certification, standard, or documentation behind the information.

ID
source_label
Evidence linkLink

Optional. Link to supporting documentation or a relevant page in the store.

ID
source_link
Open this group by defaultCheckbox
ID
open_by_default
Default
Off

@theme @theme

Added inside each Group, and reordered within it.

This section has no settings of its own.

Proof point proof max 3

IconDropdown
ID
icon
Default
Verified
  • Nonenone
  • Verifiedverified
  • Leafleaf
  • Recyclablerecycle
  • Traceabletraceable
HeadingText
ID
heading
Default
Transparent formula
Supporting textText

Keep claims factual and remove any proof point that does not apply to the product.

ID
text