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.
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:
- Parts counter: customers look up one part number or paste a parts list of up to 50 lines. Every line is checked against your catalog before anything is added to the cart.
- Parts table: collection pages and search results list one row per variant, with part number, price, stock and a quantity field. Customers can switch to a product grid.
- Exact part-number search: a search that matches a part number shows that part first, ready to add to the cart.
- Shop by fit: products are grouped by the machine or equipment they fit.
- Cart order sheet: the cart lists part numbers and quantities, copies out as a part list and accepts more parts by number.
- Product pages with a part strip, specification table, cross-references, datasheet download, other sizes, compatible parts, quantity pricing, pickup availability and the gift card recipient form.
- Sections for any page: Image banner, Rich text, Image with text, Collection list, Video, Newsletter, Collapsible content, Custom Liquid and Apps.
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
- Add the theme. In your Shopify admin, go to Online Store > Themes, add Caliper and select Customize to open the theme editor.
- Give every variant a SKU. The SKU is the part number. See Part numbers.
- 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.
- Create the custom fields you need (optional). See Custom fields (metafields).
- Add filters in the Shopify Search & Discovery app. See Filters and model family.
- 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.
- 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.
- 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.
- Part numbers can contain letters, numbers, dashes, dots, slashes, colons and underscores, up to 100 characters. Do not use spaces: the Parts counter reads a space as the gap between a part number and its quantity.
- Matching ignores upper and lower case, so
ab-100findsAB-100. - If two variants share a SKU, the Parts counter marks the line “More than one match. Open the part to choose.” Keep every SKU unique.
- Shopify updates its search index a few minutes after you add or change a SKU. A new part number can take a few minutes to appear in search and the Parts counter.
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.
| Name | Namespace and key | Type | Create for | Where it appears |
|---|---|---|---|---|
| Spec summary | caliper.spec_summary | Single line text | Product and variant | A 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. |
| Specifications | caliper.specifications | JSON | Product and variant | The specification table on product pages and in Featured product. Also the first four entries in Product close-up and the exact match panel. |
| Cross-reference | caliper.cross_reference | Single line text | Product and variant | The “Interchangeable with” row of the specification table. Use it for equivalent part numbers from other makers. |
| Fits | caliper.fitment | Single line text | Product | The part strip and specification table on product pages, the Fits column of the parts table, Shop by fit and the model family filter. |
| Lead time | caliper.lead_time | Single line text | Variant | The Dispatch and lead time block on product pages and the Lead time block in Featured product. |
| Datasheet | caliper.datasheet | File | Product | A Download data sheet button under the specification table. |
| Compatible parts | caliper.compatible | Product, list of products | Product | The 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
- Create the Fits product field (
caliper.fitment, single line text) described in Custom fields, and fill it in on your products. - Open the Search & Discovery app and select Filters, then Add filter.
- 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:
- Parts counter, with Use as page opening turned on.
- How it works, with three Step blocks.
- Product close-up. Select a product. The section stays hidden on your store until you select a product or an image.
- Product carousel. Select a collection. Until you do, four placeholder cards are shown.
- Shop by fit. Select a collection. See Shop by fit.
- 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:
AB-100, 4, or with a semicolon, tab or space between the part number and the quantityAB-100 x4,AB-100 × 4,AB-100 qty 4andAB-100 4 pcs- Quantity first with an x:
4 x AB-100 - A part number on its own, which counts as a quantity of 1
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:
- Ready: the part was found, is available and the quantity is valid.
- No part with this number: no variant has that SKU.
- More than one match. Open the part to choose.: more than one variant has that SKU.
- Sold out: the part is not available.
- Sold in packs: the quantity does not match the part’s quantity rule. The message gives the minimum, the pack size and the nearest valid quantity.
- Choose a purchase option on the product page: the product can only be sold as a subscription.
- Use: part number, quantity: the line could not be read.
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
- Use as page opening: shows the heading as the page title. Applies when the section is first on the page.
- Content: Subheading, Heading and Text.
- Highlights: First highlight, Second highlight and Third highlight, shown as a checklist beside the heading. Leave a line blank to hide it.
- Find one part: Search placeholder, Search placeholder on phones, Suggest part numbers from your catalog and Example part numbers (up to four, separated by commas). With Suggest part numbers from your catalog turned on and no example part numbers entered, the counter shows the part numbers of up to four available products from your store.
- Paste a list: Example list. Enter one part number and quantity per line, separated by a comma. Customers can select Load an example to see how the counter works.
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
- 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. - 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 taggedfits: Varnholt compressor VC40is 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
- Each variant gets its own row, up to six per product. Products with more variants show a link to the remaining part numbers.
- The columns are Part no., Item, Price, Availability and Order. Rows show quantity price breaks, for example “Less from 10+”.
- A Specifications column is added when at least one listed part has a Spec summary, or, for products with several variants, a variant Specifications field. For those variants, the row shows the first three values.
- A Fits column is added when at least half of the rows have a Fits value. With fewer, rows that have one show it as a short line under the item name. On a collection where every product fits the same machine and the collection title already names it, fitment is not repeated on each row.
- Customers can enter quantities in several rows and add them together with Add selected to cart. Each row also works on its own without JavaScript.
- Quantity fields follow each variant’s minimum, maximum and increment. Parts that cannot be added from the table, such as sold-out or subscription-only parts, link to the product page.
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).
Search
- Exact part-number search: when a search matches a variant’s SKU exactly, an Exact part match panel shows that part first, with its image, spec summary, price, stock, up to four specifications and an Add to cart button. The other results follow.
- Results: products are listed in the parts table, followed by matching articles and pages. Filters and sorting are available.
- Predictive search: as customers type in the header search field or on the search page, suggestions show matching products with prices, collections, pages and articles.
- Part number search in the header: turn on Show part number search in the Header section. Customers can press / on any page to jump to the field. The footer has its own Show part number search setting.
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
- Show breadcrumb: Catalog / collection or product type / part number.
- Show other sizes of this part and Maximum sizes shown (2 to 20, default 8): lists the product’s other variants with part number, spec summary and price. The list is hidden when the product has a single option shown in the Variant options block, because every size is already a button there.
- Show compatible parts, Compatible parts and Maximum compatible parts shown (2 to 12, default 6). The list shows the products chosen in the Compatible parts setting first, or each product’s Compatible parts field (
caliper.compatible). To show each product’s own list, connect the setting to that field with the connect button. Without either, it shows the complementary products set in the Search & Discovery app.
Blocks
- Title: Show spec summary and Spec summary text. The line under the title uses the Spec summary text, then the selected variant’s Spec summary field, then the product’s.
- Price: includes a Quantity pricing table when the variant has quantity price breaks.
- Variant options.
- Dispatch and lead time: Dispatch line and Default lead time. A variant’s Lead time field is always shown. Otherwise, the Default lead time is shown when the part is sold out, and the Dispatch line is shown when it is in stock. Leave the Dispatch line blank to hide it.
- Buy buttons: Show accelerated checkout. Gift card products show the gift card recipient form.
- Technical specifications: Specifications text (optional, can be connected to any product field). See below.
- Description, Collapsible row (Heading and Body text), Custom Liquid and app 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.
- Copy part list copies the order as
part number, quantitylines, ready to paste into the Parts counter later or into a purchase request. - Add parts by number opens a compact Parts counter inside the cart, with the same line-by-line check.
- Order note accepts a PO number, delivery notes or a job reference.
- Quantities follow each variant’s quantity rules, and line item properties are kept.
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
- Brand: Logo, Logo width (80 to 280 px, default 160 px) and Favicon.
- Typography: Heading font, Heading capitals (All capitals or As typed), Body font, Part number font (used for part numbers, specifications, prices and labels) and Heading size (80% to 120%).
- Colors: Background, Text, Surface, Surface text, Button background, Button text, Accent color (section numbers, active states and the parts counter), Text on accent color and Borders.
- Layout: Corner radius (0 to 24 px), Use cart drawer and Show section numbers (numbers such as § 02 next to each section’s subheading).
- Parts tables: Default collection layout (Parts table or Product grid) and Row spacing (Comfortable or Compact).
- Product cards: Card style (Flat with thin borders or Framed cards).
- Parts counter: Counter style (Ruled lines on the background or Dark panel).
- Social media: Facebook, Instagram, YouTube, TikTok, X (Twitter), Threads, Pinterest, LinkedIn, Snapchat, Tumblr and Vimeo. Enter the full address of each profile.
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.
- Include your store URL, the theme version, the affected page and the steps to reproduce the issue. A screenshot helps.
- Never include passwords, payment details or customer information.
- Support covers setup questions and defects in Caliper. Custom code changes, problems caused by edits to theme code, and third-party apps and services are not included.
Release notes
Version 1.0.0 · November 2026
The first release of Caliper.
- Parts counter: look up one part number or paste a parts list of up to 50 lines, with every line checked before it reaches the cart.
- Parts table with one row per variant, optional Specifications and Fits columns, and a switch to a product grid.
- Exact part-number search and predictive search for products, collections, pages and articles.
- Shop by fit, grouped by the Fits field or by product tags.
- Cart order sheet with Copy part list and Add parts by number.
- Product pages with a part strip, specification table, cross-references, datasheet download, other sizes, compatible parts, quantity pricing, pickup availability and the gift card recipient form.
- Image banner, Rich text, Image with text, Collection list, Video, Newsletter, Collapsible content, Custom Liquid and Apps sections.
- Social media icons, newsletter signup, Follow on Shop, country and language selectors and payment icons in the footer.
- Password page with email signup, and a gift card page with QR code, Apple Wallet, Copy code and Print gift card.
- One preset, Caliper.