Product data

The theme reads eight product data fields. Each field is a metafield. A metafield is extra data that you add to a product or a variant.

Each field has a theme setting that holds its key. The keys below are the defaults. If you already store the same data in another field, change the setting to your key. You do not need to create a second field.

How the theme reads a field

• The theme reads the variant value first. If the variant has no value, it reads the product value.
• A blank field shows nothing on the storefront.
• Store numbers without units. Enter 40 for 40 mm. The unit is part of the specification text, not the number.

The eight fields

1. Part number

• What it does: shows the manufacturer part number in the product identifiers and in table rows. The search does not read this field. A buyer finds a part number in search only when the same value is also the variant barcode or a product tag.
• Metafield type: single line text.
• Default key: custom.mpn. Theme setting: Part number metafield.
• Example value: M10-40-ZP

2. Pack size

• What it does: shows the pack line, for example "Pack of 50". With Show price per unit on, it also shows the price for each unit. Nothing shows when the value is blank or 1.
• Metafield type: integer.
• Default key: custom.pack_size. Theme setting: Pack size metafield.
• Example value: 50

3. Pack unit

• What it does: names the selling unit in the pack line, for example pack, box, case, reel or drum. When the field is blank, the theme uses the default word "pack".
• Metafield type: single line text.
• Default key: custom.pack_unit. Theme setting: Pack unit metafield.
• Example value: box

4. Minimum order

• What it does: shows a minimum, for example "Minimum 5". It also sets the lowest quantity in the quantity box. The theme uses this only when there is no native B2B quantity rule. It is an input rule, not a checkout rule.
• Metafield type: integer.
• Default key: custom.minimum_order. Theme setting: Minimum order metafield.
• Example value: 5

5. Order multiple

• What it does: shows the step, for example "sold in multiples of 5". The quantity box moves in steps of this number. The theme uses this only when there is no native B2B quantity rule. It is an input rule, not a checkout rule.
• Metafield type: integer.
• Default key: custom.order_multiple. Theme setting: Order multiple metafield.
• Example value: 5

6. Lead time

• What it does: shows how many working days the product takes to dispatch when it is not in stock, for example "Dispatched in 10 working days". When the field is blank, the theme uses Default lead time in working days from the theme settings.
• Metafield type: integer.
• Default key: custom.lead_time_days. Theme setting: Lead time metafield.
• Example value: 10

7. Specifications

• What it does: fills the specification table on the product page, the specification columns in collection tables, and the compare page.
• Metafield type: JSON.
• Default key: custom.specifications. Theme setting: Specifications metafield.
• Example value:

{"Thread": "M10", "Length": "40 mm", "Finish": "Zinc plated"}

Follow these rules for the JSON:

• The value must be one JSON object, with curly braces at the start and end.
• Put every name and value in double quotes.
• Separate pairs with a comma. Do not put a comma after the last pair.
• The name on the left is the row name. The table shows the rows in the order they are written.
• Use the same names in every product. The collection columns and the compare page match rows by name.

8. Documents

• What it does: shows a list of links to files, such as data sheets and certificates. Each link shows the file type and file size.
• Metafield type: list of files (a list of file references).
• Default key: custom.documents. Theme setting: Documents metafield.
• Example value: two uploaded files: a data sheet PDF and a certificate PDF.

Upload the files first in Shopify admin under Content > Files. Then add them to the field.

Create the fields in Shopify

1. In Shopify admin, go to Settings > Custom data.
2. Choose Products. Add a definition for each field. Use the name, namespace and key from the list above, and the type from the list above.
3. Choose Variants. Add the same definitions. The theme reads the variant value first, so use the variant field for values that change by variant, such as part number, pack size and lead time.
4. Repeat for all eight fields.

Map an existing field

Use this when your store already has a field for the same data.

1. In the theme editor, open Theme settings and go to the group Product data.
2. In the setting for that field, type your field in the form namespace.key. For example, specs.thread_size. Do not add quotes or spaces.
3. Check one product page to see that the value shows.

Fill the fields with a CSV import

1. In Shopify admin, export your products first. Use this file as your template.
2. Open the exported file. Find the columns that hold the metafields. Each one has a header that names the field. Copy these header names exactly. Do not rename the headers.
3. Fill one row for each product or variant. Enter numbers without units. Enter specifications as JSON in the cell, using the rules above.
4. Import the file in Shopify admin. Start with one product. Check its product page before you import the full list.

Test one product before a large import. Check that the value for each field shows as you expect.