Managing battery products

👤 Ops

Battery products are ordinary Shopify products — you add and edit them in the Shopify admin like any other. What's special about CBP is the link between a product and the vehicle fitment data.

Adding a new battery

1. Products → Add product in the Shopify admin.
2. Fill the standard fields: Title, Description (a short overview only — detailed content goes in the metafields below), Media (hero image), Price, Inventory, and Variants if applicable.
3. Set Vendor to the brand (Varta, Amaron, Panasonic, etc.).
4. Set Product type (e.g. Car battery).
5. Add it to the relevant Collections (e.g. All batteries, the brand collection, a vehicle-fitment collection).
6. Scroll to the Metafields section at the bottom of the product page and fill in the four custom metafields described below.
7. Save. The product appears on the storefront using the Product template.

Shopify references: adding products, variants, collections.

Custom product metafields

These four metafields drive the bespoke parts of the product page (PDP) and the product quick-view. They all live in the custom namespace and are edited at the bottom of the product page in the admin. See Shopify's metafields guide.

Editing or removing a battery

• Editing: open Products → (battery), change the fields and metafields, and Save. Changes go live immediately.
• Removing: prefer Set as draft rather than delete, so existing orders and customer history stay intact. Drafts disappear from the storefront automatically.

The golden rule: SKUs must match

A battery only shows up as "fits this vehicle" when its SKU in Shopify matches the SKU in the fitment data that the CBP API returns. See Vehicle lookup & battery compatibility for how the matching works.

Checklist when a battery should appear but doesn't

1. Confirm the product is active and in the right sales channel/collection.
2. Confirm the variant SKU exactly matches the fitment SKU (no extra spaces, correct case).
3. Confirm the vehicle actually has that battery in its fitment list (the API, not Shopify, decides this).
4. If the SKU is correct and it still doesn't show, the fitment data itself may be missing the mapping — this is an API/data matter; see Escalation & contacts.

Vehicle fitment badges

The "fits your vehicle" badges on collection pages come from the lookup API (see Vehicle lookup), not from a metafield. There's nothing to set on the product for this beyond the SKU rule above.

Developer reference

• Metafield reads: templates/product.json (key_features, specifications via the metafield_tag filter); sections/product.liquid (pdp_bullet_points loop ~line 94, product_datasheet button ~line 207); sections/product-quick-view.liquid surfaces the same metafields in the quick-view.
• Vehicle suitability callouts: assets/vehicle-suitability.js reads the selected vehicle from window.theme.vehicleDetails (localStorage) and updates collection-page badges.
• Product card badge logic: snippets/component.product-card-badge.liquid.