Proof ledger

A list of documents backing your claims — assay reports, stability testing, allergen panels — each with a title, date, and an honest provenance label distinguishing third-party verification from internal testing.

Merchant-addable
Yes
Settings
50
Block types
1
Max blocks
8
File
sections/proof-ledger.liquid

Used by default on: page.our-standards, Product, Product (set)

When to use it

Categories where trust is the barrier to purchase and you have real documentation to show. Skip it entirely if you do not.

Setting it up

  1. Add the section and write the heading and intro under Content. Mobile header alignment sets the eyebrow, heading, and body text to left or center on phones.
  2. New sections start with the eyebrow Evidence and testing, heading Proof, documented., and introduction The testing, sourcing, and standards behind this formula, supplied and substantiated by the brand. The band and card both use scheme 3, with 72px top and bottom padding. The four starter records are Clinical testing, Ingredient sourcing, Certifications, and Quality standards. Clinical testing starts open; Certifications reads the product certifications and standards attribute, falling back to its typed details.
  3. Heading size matches Product dossier and Protocol timeline: Small scales from 28 to 40px, Medium from 32 to 56px, and Large from 36 to 72px with the viewport. Medium is the default. Below 750px, the sizes are 20, 24, and 28px. Record heading size controls the record titles separately.
  4. Set your provenance wording under Record labels and badges. There are separate labels for supplied and not-supplied states — use both honestly.
  5. Add one Proof record block per document, with its title, date, and status. The ledger holds up to eight records, and one is open at a time: opening a record closes the one before it. Open the first record by default or a record's own Open this record by default chooses which starts open; if several are set, the first one wins.
  6. Content width under Style is Standard by default, which holds the ledger at 1200px on wide screens so rows and metadata keep their proportions and line up with Product reviews below. Wide fills the page width.
  7. The ledger is a card on a band. Color scheme paints the band and Card color scheme paints the card, so a white card can sit on a cream band. Show card shadow lifts the card off the band and is on by default.
  8. Attach media under Media if you have a document image or scan to show. On phones, Media position on mobile chooses where it goes: Above the records (the default), Below the records so the records come straight after the heading and the image closes the section, or Hidden. An uploaded Custom image always shows. Without one, product pages show the product being viewed, and pages without a product, such as the home page, show a default illustration.
  9. To show a video instead, set Media type to Video and use Upload video. Turn on Autoplay video to start it automatically: it plays muted and looped while on screen, never starts for shoppers who prefer reduced motion, and the play button stays available to pause it. The video downloads nothing until it is on screen and playing. Before then the section shows the video's preview image. If JavaScript is unavailable, the browser's native video controls remain available for manual playback.
  10. Choose Image style under Media. Blend into background fills the story column and fades the top of the image into the section background below the heading, so the photograph reads as part of the header. Framed keeps the image in its own box, with its own corner radius control. Either way the image keeps its own shape, held between 4:5 portrait and 3:2 landscape, and Image width on desktop sets how much of the section it takes. On phones a portrait image is held to square at most, so the records start sooner.
  11. A certifications record can pull straight from the product: set Value source on that block. On pages without a product, such as the home page, the block shows its typed details instead. A resolved product value keeps the record visible even with the default heading and no manual evidence, and uses the supplied-state label. If the product value is missing, the block uses its typed details; a default record with no evidence stays hidden on the storefront. Documents, dates, and methods stay manual. See Per-product content.

Where the content comes from

Blocks own record headings, documents, dates, methods, links, and manual details. An optional Value source pulls the details from the viewed product's Shopify category attributes, with the typed details as fallback. Shopify has no native field for a test report.

Notes and cautions

  • Label internal testing as internal. Presenting in-house results as independent verification is the kind of thing that costs a brand its credibility permanently, and it is the sort of claim regulators read closely.
  • A ledger with three real documents beats one with ten vague ones.

Custom values in evidence records

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 evidence record and select Custom product metafield.
  4. Enter the definition’s full namespace and key, such as custom.testing_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.

Starting defaults

New Proof ledger sections match the product template: Evidence and testing above Proof, documented., followed by “The testing, sourcing, and standards behind this formula, supplied and substantiated by the brand.” The band and card use scheme 3, with 72px top and bottom padding.

The preset adds Clinical testing, Ingredient sourcing, Certifications, and Quality standards, in that order. Clinical testing starts open. Certifications reads the viewed product’s certifications and standards attribute, with its typed details as fallback. The other records use manual details. Blocks own headings, documents, dates, methods, links, and manual details; the product attribute supplies only the Certifications details.

These defaults apply when adding a new section. Existing section instances keep their saved values.

Enter real evidence

New records leave document, date, method, details and links empty. Fill them only with information you can substantiate. Records without evidence stay hidden from shoppers and remain available in the editor. Starter headings identify topics; they do not claim that a test occurred. Block settings own the manual evidence; optional Shopify product attributes own resolved product details.

Complete legacy sample records do not publish example dates, documents, methods or collection links. Real resolved product details still appear. Edited merchant evidence keeps its values. Metadata tooltip controls have at least 24px height, visible keyboard focus and responsive botanical fallback art.

Proof ledger 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
Evidence and testing
HeadingText
ID
heading
Default
Proof, documented.
Heading sizeDropdown
ID
heading_size
Default
Medium
  • Smallsmall
  • Mediummedium
  • Largelarge
Record heading sizeDropdown
ID
record_heading_size
Default
Medium
  • Smallsmall
  • Mediummedium
  • Largelarge
Body textRich text
ID
introduction
Default
<p>The testing, sourcing, and standards behind this formula, supplied and substantiated by the brand.</p>
Mobile header alignmentDropdown

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

ID
mobile_header_alignment
Default
Left
  • Leftleft
  • Centercenter
Open the first record by defaultCheckbox
ID
open_first
Default
On
Show the merchant substantiation disclosureCheckbox
ID
show_disclosure
Default
On

Record labels and badges

Document headingText
ID
document_label
Default
Document
Date headingText
ID
date_label
Default
Date
Method headingText
ID
method_label
Default
Method
Show the status badgeCheckbox
ID
show_status_badge
Default
On
Supplied badge textText
ID
merchant_supplied_label
Default
Merchant-supplied
Shown when
show_status_badge
Not supplied badge textText
ID
not_supplied_label
Default
Not supplied
Shown when
show_status_badge
Supporting noteRich text
ID
disclosure_text
Default
<p>Claims, results, and documentation are provided and substantiated by the merchant.</p>
Shown when
show_disclosure
Supporting note iconDropdown
ID
disclosure_icon
Default
Sparkle
Shown when
show_disclosure
  • Nonenone
  • Botanicalbotanical
  • Leafleaf
  • Dropletdroplet
  • Sparklesparkle
  • Lipsticklipstick
  • Compactcompact
  • Brushbrush
  • Heartheart
  • Capsulecapsule
  • Custom imagecustom
Supporting note icon rotationSlider
ID
disclosure_icon_rotation
Default
0
Range
-30° to 30°, in steps of 1°
Shown when
show_disclosure and disclosure_icon is not 'none'
Custom supporting note iconImage

Use a small transparent image with a simple silhouette.

ID
disclosure_icon_image
Shown when
show_disclosure and disclosure_icon is 'custom'

Media

Show mediaCheckbox
ID
show_media
Default
On
Media position on mobileDropdown

Below the records brings the records up under the heading on phones and closes the section with the image or video. Larger screens keep their layout.

ID
mobile_media_position
Default
Above the records
Shown when
show_media
  • Above the recordsabove
  • Below the recordsbelow
  • Hiddenhidden
Media typeDropdown
ID
media_type
Default
Image
Shown when
show_media
  • Imageimage
  • Videovideo
Upload videoVideo

Uploaded videos play in the media panel after the shopper selects the play button.

ID
video
Shown when
show_media and media_type is 'video'
Autoplay videoCheckbox

Autoplaying videos play silently in a loop only while on screen and respect reduced-motion preferences. The play button stays available to pause them.

ID
video_autoplay
Default
Off
Shown when
show_media and media_type is 'video'
Custom imageImage

Replaces the product image. Pages without a product show a default illustration until you upload an image. 4:5 aspect ratio recommended.

ID
image
Shown when
show_media
Image labelText
ID
image_label
Default
Proof of concept
Shown when
show_media
Image captionText
ID
image_caption
Default
A closer look at the documentation behind this formula.
Shown when
show_media
Image styleDropdown

Blend fills the column and fades the top of the image into the section background below the heading.

ID
media_style
Default
Blend into background
Shown when
show_media
  • Blend into backgroundblend
  • Framedframe
Image position on desktopDropdown
ID
image_position
Default
Left
Shown when
show_media
  • Leftleft
  • Rightright
Image width on desktopSlider
ID
desktop_media_width
Default
34
Range
28% to 46%, in steps of 2%
Shown when
show_media
Image fitDropdown
ID
image_fit
Default
Fill
Shown when
show_media
  • Fillcover
  • Fitcontain
Image corner radiusSlider
ID
image_corner_radius
Default
0
Range
0px to 32px, in steps of 2px
Shown when
show_media and media_style is 'frame'
Use custom corner radiusCheckbox
ID
use_custom_section_radius
Default
Off
Section corner radiusSlider
ID
section_corner_radius
Default
0
Range
0px to 48px, in steps of 2px
Shown when
use_custom_section_radius

Style

Content widthDropdown

Standard keeps the ledger at 1200px on wide screens, matching product reviews. Wide fills the page width.

ID
content_width
Default
Standard
  • Standardstandard
  • Widewide
Color schemeColor scheme
ID
color_scheme
Default
scheme-3
Card color schemeColor scheme

Colors the ledger card. Color scheme above colors the band around it.

ID
card_color_scheme
Default
scheme-3
Show card shadowCheckbox

Lifts the ledger card off the section background.

ID
show_card_shadow
Default
On
Show entrance animationCheckbox

Fades the section in on scroll. Respects the theme animation setting and reduced motion.

ID
enable_entrance_animation
Default
On
Top paddingSlider
ID
padding_top
Default
72
Range
0px to 120px, in steps of 4px
Bottom paddingSlider
ID
padding_bottom
Default
72
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.

Proof record record max 8

HeadingText
ID
heading
Default
Proof record
Document nameText

Enter only documentation the merchant can substantiate.

ID
document
Documentation dateText

Use the date shown on the merchant's supporting documentation.

ID
date
MethodText

Describe the substantiated testing, sourcing, or certification method.

ID
method
Value sourceDropdown

Fills the details from the product, which suits a certifications record. The typed details appear when the product has no value. Documents, dates and methods stay manual.

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
  • SPF levelspf-level
  • UVA protection gradeuva-protection-grade
  • pH levelph-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'
Evidence detailsRich text

Supply factual, substantiated information. Do not add unsupported performance, medical, or certification claims.

ID
details
Document linkLink

Optional. Link to merchant-supplied supporting documentation or a relevant store page.

ID
document_link
Method notes linkLink

Optional. Link to additional merchant-supplied methodology notes.

ID
method_link
Open this record by defaultCheckbox

One record is open at a time. If you choose to open several records, the first one opens.

ID
open_by_default
Default
Off