Caliper theme / documentation

Order by part number.

Caliper is a Shopify theme for stores that sell parts, tools and other items that customers look up by part number or specification. Customers search by part number, paste whole parts lists, compare parts in a table and add them to the cart from any row.

Version 1.0.0 · One preset: Caliper

Overview

Caliper treats every product variant as a part number. A variant’s SKU is shown as its part number on product pages, in the parts table, in search results, in the Parts counter and in the cart. The main features are:

Every feature works with Shopify’s standard product data. The optional custom fields described below add specifications, fitment, lead times, datasheets and compatible parts.

Getting started

  1. Add the theme. In your Shopify admin, go to Online Store > Themes, add Caliper and select Customize to open the theme editor.
  2. Give every variant a SKU. The SKU is the part number. See Part numbers.
  3. Set up your menus in Content > Menus. The Header section uses the menu selected in its Menu setting (Main menu by default). The Footer section shows a Catalog menu and a Footer menu, which you choose in the Footer section.
  4. Create the custom fields you need (optional). See Custom fields (metafields).
  5. Add filters in the Shopify Search & Discovery app. See Filters and model family.
  6. Set up the homepage. Select a product for Product close-up, a collection for Product carousel and Shop by fit, and a blog for Blog posts. See Homepage.
  7. Add your brand. Upload your logo and favicon in Theme settings > Brand, then review Typography and Colors. Add your profile links in Theme settings > Social media.
  8. Preview and save. Check the homepage, a collection, a product page, search and the cart on a phone and a desktop before you publish. Duplicate the theme before you edit its code.

Part numbers

Give each variant a unique SKU in the product editor. The Parts counter, the parts table, exact part-number search and the cart all read the variant SKU.

Custom fields (metafields)

Caliper reads the product and variant custom fields below when they exist. They are all optional: products without them still display normally. To create one, go to Settings > Metafields and metaobjects (Custom data in some admins), choose Products or Variants, select Add definition, enter the name, set the namespace and key exactly as shown, choose the type and save. Fields marked “Product and variant” need two definitions with the same namespace and key, one under Products and one under Variants. A variant’s value is used before the product’s value.

Custom field definitions read by Caliper
NameNamespace and keyTypeCreate forWhere it appears
Spec summarycaliper.spec_summarySingle line textProduct and variantA short line such as “25 mm bore, sealed” under the product title, in the parts table, on product cards and in the exact match panel.
Specificationscaliper.specificationsJSONProduct and variantThe specification table on product pages and in Featured product. Also the first four entries in Product close-up and the exact match panel.
Cross-referencecaliper.cross_referenceSingle line textProduct and variantThe “Interchangeable with” row of the specification table. Use it for equivalent part numbers from other makers.
Fitscaliper.fitmentSingle line textProductThe part strip and specification table on product pages, the Fits column of the parts table, Shop by fit and the model family filter.
Lead timecaliper.lead_timeSingle line textVariantThe Dispatch and lead time block on product pages and the Lead time block in Featured product.
Datasheetcaliper.datasheetFileProductA Download data sheet button under the specification table.
Compatible partscaliper.compatibleProduct, list of productsProductThe Compatible parts list on product pages.

Enter Specifications as label and value pairs, in the order they should appear, for example {"Bore": "12 mm", "Width": "8 mm", "Seal": "Rubber, both sides"}. After you create the definitions, fill in the values in the Metafields card at the bottom of each product and variant page in your admin.

Filters and model family

Filters and sorting appear on collection pages and search results, in both the parts table and the product grid. Add filters in the Shopify Search & Discovery app, for example availability, price, product type, vendor and option values such as Size.

Add the model family filter

  1. Create the Fits product field (caliper.fitment, single line text) described in Custom fields, and fill it in on your products.
  2. Open the Search & Discovery app and select Filters, then Add filter.
  3. Choose the Fits product metafield as the source, set the filter label to Model family and save.

Customers can then narrow a collection or search to the parts for one model. Shop by fit also uses this filter: when it groups products by the Fits field, each group links to its collection with the filter applied. The filter only groups your own Fits values. It does not check whether a part really fits a machine, so keep that information accurate.

Homepage

The default homepage contains these sections, in this order:

  1. Parts counter, with Use as page opening turned on.
  2. How it works, with three Step blocks.
  3. Product close-up. Select a product. The section stays hidden on your store until you select a product or an image.
  4. Product carousel. Select a collection. Until you do, four placeholder cards are shown.
  5. Shop by fit. Select a collection. See Shop by fit.
  6. Blog posts. Select a blog with articles.

You can reorder, hide or remove any of them and add the other sections listed in Sections for any page.

How it works

Settings: Subheading, Heading, Heading second line and Text. Add up to four Step blocks (Title and Text) to replace the text with a numbered sequence.

Product close-up

Settings: Product, Main image (leave blank to use the product’s featured image), Show part number and specifications, Subheading and Heading. Show part number and specifications lists the part number and the first four entries of the Specifications field. Add up to six Detail blocks. Each has a Label, Heading and Description, a numbered marker that you place on the main image with Position from left and Position from top, and an optional detail Image. Without an image, the block shows a zoomed crop of the main image, set by Zoom, Zoom focus from left and Zoom focus from top.

Product carousel

Settings: Collection, Subheading, Heading, Text and Products to show (4 to 24, default 12). Arrows appear only when there are more cards than fit on the screen.

Blog posts

Settings: Subheading, Heading, Text, Blog and Posts to show (2 to 8, default 4). Each post shows its first tag, a short excerpt and an estimated reading time.

Parts counter

The Parts counter gives customers two ways to order.

Find one part

Customers type a part number, size or keyword and go to the search page. An exact part number is shown first, ready to add to the cart (see Search). Example part numbers appear under the field as one-tap searches.

Paste a list

Customers paste up to 50 lines from a spreadsheet, or type them, with one part number and quantity per line. Lines beyond 50 are not checked. These formats are accepted:

Repeated part numbers are added together on the first line where they appear. When the customer selects Check list, every line is checked against your catalog and marked:

The checked list shows the item, unit price and line total for each line, with a subtotal. Only Ready lines are added to the cart. Customers can fix the marked lines and check again.

Settings

Change the look of every Parts counter in Theme settings > Parts counter > Counter style.

Shop by fit

Shop by fit groups the products of one collection by the machine or equipment they fit. Each group lists products with a part number and a count of their other part numbers, and links to all the parts for that fit. When there is more than one group, customers can show one fit at a time.

How products are grouped

  1. By the Fits field. If any product in the collection has the Fits product field (caliper.fitment) filled in, products are grouped by that value. Each group links to the collection filtered by the model family filter, so add that filter as described in Filters and model family.
  2. By product tags. If no product in the collection has the Fits field, products are grouped by tags that start with the Machine tag prefix. With the default prefix fits:, a product tagged fits: Varnholt compressor VC40 is listed under “Varnholt compressor VC40”. A product can have several of these tags. Each group links to the collection’s tag page, which needs no setup. Clear the prefix to ignore tags.

The section reads the first 50 products of the collection. Products with no fit are left out. If nothing can be grouped, the section is hidden on your store, and the theme editor shows a setup hint instead.

Settings

Content: Subheading, Heading and Text. Parts: Collection, Machine tag prefix (default fits:) and Products per group (3 to 10, default 5). Groups with more products link to the full list.

Collection pages and the parts table

Collection pages open as a parts table by default. Change this in Theme settings > Parts tables > Default collection layout. Customers can switch between Parts table and Grid, and their choice is remembered on their device.

Parts table

Row spacing is set in Theme settings > Parts tables > Row spacing. The product grid uses the product cards set in Theme settings > Product cards.

Collection section settings

Show collection image, Show collection image on phones (off by default, which keeps the parts list on the first screen of a phone) and Products per page (12 to 48, default 24).

Product pages

Every product page shows a part strip with the selected part number, the product type, the Fits value and availability. It updates when a customer selects another variant.

Product section settings

Blocks

Specification table

The Technical specifications block lists the Specifications field of the selected variant, or of the product. When neither has one, the table is built from the selected variant’s option values, the product type and the vendor (shown as Type and Brand). The Fits value and the Cross-reference (shown as “Interchangeable with”) are added below. A Datasheet file adds a Download data sheet button. When there is nothing to list, a setup hint is shown in the theme editor only.

Media and pickup

Product media supports images, videos and 3D models, including View in your space. Pickup availability is shown for locations that offer local pickup.

The default product template also has a Product recommendations section (Related, four products). Its settings are Subheading, Heading, Recommendation type (Related or Complementary) and Products to show (2 to 8).

Cart

The cart page and cart drawer read as an order sheet: part number, item, unit price, quantity and line total on every line, with a count of lines and pieces. Turn the drawer on or off in Theme settings > Layout > Use cart drawer.

The Cart and Cart drawer sections accept app blocks and Custom Liquid blocks.

Sections for any page

Add these sections to the homepage or to any page template. Most of them have Subheading (shown next to the section number), Top padding and Bottom padding settings.

Image banner

Image (2400 x 1200 px recommended), Height (Small, Medium, Large or Adapt to image), Full page width, Subheading, Heading, Text, Text box position on desktop (Bottom left, Bottom right, Top left or Center) and two buttons, each with a label and a link. On phones, the text box sits under the image.

Rich text

Layout (Split, Left or Center). Blocks: Heading (up to three, each with a Small, Medium or Large size), Text and Button (up to two, Solid or Outline).

Image with text

Image, Image position on desktop (Left or Right), Image shape, Figure number and Caption. Blocks: Heading (one), Text, Specification row (Label and Value) and Button (up to two).

Collection list

Heading, Show link to all collections, Columns on desktop (2 to 4), Image shape and Show product count. Add up to 12 Collection blocks.

Video

Heading, Text, Shopify-hosted video, YouTube or Vimeo link, Video description (read by screen readers), Caption and Full page width. A Shopify-hosted video plays instead of the link when both are set.

Newsletter

Heading, Text and Note under the field. Subscribers are added to your customer list with the newsletter tag and marked as accepting marketing.

Collapsible content

Heading, Text and Open the first row. Add Collapsible row blocks, each with a Question or heading, an Answer and optional Page content for longer text such as a full policy.

Custom Liquid and Apps

Custom Liquid adds your own Liquid code. Apps holds app blocks and Custom Liquid blocks.

Other sections

Featured collection (Products to show: 4, 8 or 12), Featured product (with the same blocks as product pages, including Technical specifications and Lead time), Product features (up to six Feature blocks, each with an image, heading and description), Product recommendations, How it works, Product close-up, Product carousel, Shop by fit, Blog posts and Parts counter can also be added to any page.

Page templates

The Page section has Show page title, Content width and Title alignment. The Article section can show the featured image, a details column with the date, topics and a link back to the blog, and an estimated reading time. The Password page section has Show email signup, for customers waiting for the store to open.

Theme settings

Presets

Caliper has one preset, Caliper: warm paper background, dark ink text, a signal orange accent color and square corners. Headings use Sofia Sans Extra Condensed in capitals, body text uses IBM Plex Sans and part numbers use IBM Plex Mono. For a different look, change Counter style, Row spacing and Card style in Theme settings.

Accessibility

Caliper respects the reduced-motion preference set on a customer’s device. If you change colors, keep enough contrast between Accent color and Text on accent color, and between Text and Background. Add descriptive alt text to your images in Content > Files and the product editor.

Frequently asked questions

Do I need the custom fields?

No. Caliper works with SKUs alone. Without the Specifications field, the specification table uses the variant options, product type and vendor. Add the custom fields when you want specification summaries, fitment, lead times, datasheets or compatible parts.

Does the model family filter check that a part fits?

No. It groups products by your own Fits values. Keep that information accurate with your suppliers.

What happens to lines the Parts counter cannot match?

They stay in the checked list with the reason, and nothing is added for them. Customers can correct the line and check the list again.

Why does a part number I just added show “No part with this number”?

Shopify updates its search index a few minutes after a SKU is saved. Wait a few minutes and check again. Also make sure the product is active and available on the Online Store sales channel.

Why is there no Specifications or Fits column in my parts table?

The columns appear only when the listed parts have that information. See Collection pages and the parts table.

Why is Shop by fit not showing on my store?

Select a collection in the section, then fill in the Fits field or add tags that start with the Machine tag prefix. The section stays hidden until at least one product in the collection has a fit.

Why is Product close-up not showing on my store?

Select a product or an image in the section settings.

How can customers reorder?

In the cart, Copy part list copies every part number and quantity. Customers can keep the list and paste it into the Parts counter for their next order.

Do I need an app?

No. Every theme feature works without an app. Filters and complementary products use the Shopify Search & Discovery app.

Support

Support is provided through the support form only. We aim to reply within two business days.

Release notes

Version 1.0.0 · November 2026

The first release of Caliper.