Batten
Color theme

Settings reference

Every setting on all six blocks, and what each one changes.

All six blocks share three source modes and a common set of layout settings. What differs is which metafield shape each block reads.

Spec table

SettingWhat it does
SourceSeparate metafields, one metaobject, or a list of metaobjects.
RowsOne line per row, written as label, then namespace and key, with an optional third part for a unit suffix. For example Weight, specs.weight, approx.
Metaobject metafieldUsed when the source is one metaobject or a list. Points at the metafield holding the reference.
Field keysWhich metaobject fields supply the label, value, and unit. Defaults are label, value, unit.
Show column labelsAdds a header row with two column labels you set.
Show rows with no valueOff hides a row whose metafield is empty. On keeps the row with an empty second cell.
Striped rowsAlternating row background from the theme's surface color.
Compact spacingTightens row padding for long tables.
Maximum widthCaps the table width in pixels. The table scrolls inside its own container on narrow screens rather than making the page scroll sideways.

Accordion group

SettingWhat it does
SourceList of metaobjects, or separate metafields.
Rows metafieldThe metaobject list to repeat over.
Field keysWhich metaobject fields supply the row title and content. Defaults are title and content.
RowsUsed with separate metafields. One line per row, written as a label followed by a namespace and key.
Open the first rowThe first row starts open on page load.
Open one row at a timeOpening a row closes the others in browsers that support the exclusive accordion. Older browsers leave both open, which is the intended fallback.

The accordion is built from native details and summary elements. It is keyboard operable and works with JavaScript disabled, because the block ships none.

Nutrition facts panel

SettingWhat it does
SourceOne panel metaobject, or separate metafields.
Panel metafieldThe metaobject reference holding the whole panel.
Nutrients metafieldUsed with separate metafields. A metaobject list of nutrient rows.
Serving size, servings per container, caloriesTyped into the block when the source is separate metafields.
FootnoteFree text under the heavy rule.

Nutrient rows with indented set to true indent and lose the bold name treatment. The daily value column is right aligned and carries a percent suffix.

Downloads list

SettingWhat it does
SourceFile metafields, or a list of metaobjects.
FilesOne line per entry, written as a namespace and key followed by a label. A file list metafield renders one row per file.
Documents metafieldUsed with the metaobject source, so each row can carry a name, file, and file size.
Show file typeRenders the extension in capitals, for example PDF.

File size is only available through the metaobject source. Shopify's file object does not expose a size for a plain file metafield.

Feature badges

SettingWhat it does
SourceText list metafield, or a list of metaobjects.
Badges metafieldThe metafield or metaobject list to read.
Field keysWhich metaobject fields supply the label, icon, and caption.
Columns on desktopHow many badges sit across a row. Mobile drops to two.
Icon sizePixel size of the badge image.

Badge images carry an alt attribute from the badge label, plus width, height, and lazy loading, so the row does not shift as images arrive.

Variant description

SettingWhat it does
Variant metafieldThe variant level metafield holding the copy.
Product metafield to fall back toShown when the selected variant has no value.
Reserved heightHolds space open so switching between a one line and a four line description does not move the add to cart button.

The block ships one small script. It listens for URL changes, history navigation, form input changes, and the common theme variant change events, and swaps copy with no network request.

Plan gating

The Free plan includes the spec table block. The other five blocks appear in the theme editor on Pro. Layout, color, and spacing settings are not gated on either plan, and neither is the number of products, collections, or pages a block can appear on.

Still stuck? Send it through the support form and you will have a reply inside two business days.