> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kwebby.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metafields reference

> Every product, article and metaobject field Kelvin reads, with its type and where it shows.

Kelvin works with none of these: each row, box, badge or check hides when its field is empty. Create product definitions in **Settings → Custom data → Products → Add definition** (turn on storefront access), then fill them in on each product under **Metafields**.

## Specs (namespace `specs`)

| Key | Type | Where it shows |
| - | - | - |
| Any key listed in **Spec rows** | Single line text | Spec rows on cards (the first ones a product has), the compare table, the product page's spec table, and filters through Search & Discovery. See [Spec rows](https://docs.kwebby.com/kelvin/guides/spec-rows.md). |
| `summary` | Single line text | A short spec line in search suggestions, the hero, bundles, vertical film links and menu promos. |
| The key in a hero readout's **Specs metafield key** | Single line text | That readout's value in the [Hero](https://docs.kwebby.com/kelvin/sections/hero.md), such as `battery_life`. On install the readouts read `polling_rate`, `battery_life`, `connectivity` and `layout`; a readout with no value hides. |
| `highlights` | List of single line text, or rich text | The Overview block on the product page. |
| `specifications` | Multi-line text | Extra spec table rows, one `Label: value` per line. |
| `in_the_box` | List of single line text | The In the box block, and the hero. |
| `compatibility` | List of single line text | The Works with block; models offered by the [Compatibility finder](https://docs.kwebby.com/kelvin/sections/compatibility-finder.md). |
| `compat_note` | Single line text | A note in the product page's compatibility box. |
| `setup` | Multi-line text | Setup steps, one per line. |
| `manual` | File | A download under Setup and downloads. |
| `spec_sheet` | File | A second download under Setup and downloads. |
| `materials` | Multi-line text | Materials and repair, one `Label: value` per line. |
| `size_chart` | Multi-line text | The Size and fit side panel, one `Label: value` per line. |
| `badge` | Single line text | A custom badge on cards and the product page. |

## PC Builder (namespace `specs`)

The PC Builder's checks read these keys per part type. The tables in [PC Builder](https://docs.kwebby.com/kelvin/guides/pc-builder.md#build-specs-metafields) give each key's type, unit and the check it feeds.

| Part type | Keys (namespace `specs`) |
| - | - |
| Processor | `socket`, `generation`, `memory_types`, `max_memory_gb`, `max_memory_speed_mhz`, `peak_power_w`, `has_igpu`, `includes_cooler` |
| Motherboard | `socket`, `cpu_generations`, `bios_update_generations`, `form_factor`, `memory_type`, `memory_slots`, `max_memory_gb`, `max_memory_speed_mhz`, `m2_slots`, `sata_ports`, `connector_layout`, `front_usbc_header`, `chipset` |
| Memory | `memory_type`, `module_count`, `capacity_gb_total`, `speed_mhz`, `module_height_mm` |
| Graphics card | `gpu_length_mm`, `gpu_slot_width`, `tdp_w`, `recommended_psu_w`, `gpu_12v_2x6`, `adapter_included`, `gpu_pcie_8pin_count` |
| Storage | `storage_kind`, `capacity_gb` |
| Power supply | `psu_w`, `psu_form_factor`, `psu_12v_2x6_count`, `psu_pcie_8pin_count` |
| Case | `form_factors`, `max_gpu_length_mm`, `expansion_slots`, `max_cooler_height_mm`, `radiator_sizes_mm`, `max_radiator_mm`, `psu_form_factors`, `connector_layout`, `front_usbc`, `fans_included` |
| CPU cooler | `cooler_type`, `socket_support`, `cooler_height_mm`, `radiator_size_mm`, `max_tdp_w`, `ram_clearance_mm` |
| Case fans | `fan_count` |

## Other product fields

| Namespace and key | Type | Where it shows |
| - | - | - |
| `custom.protection_plans` | List of product references | Care+ plans on the product page and in the cart. See [Care+ protection plans](https://docs.kwebby.com/kelvin/guides/care-plus-protection-plans.md). |
| `custom.reviews` | List of metaobject references (type `customer_review`) | Review cards with the Verified purchase badge. See [Product reviews and Verified purchase](https://docs.kwebby.com/kelvin/guides/product-reviews.md). |
| `custom.badge` | Single line text | A custom badge, when `specs.badge` is empty. |
| `reviews.rating`, `reviews.rating_count` | Rating, integer | Stars on cards and the product page, written by a reviews app. |
| `shopify--discovery--product_recommendation.complementary_products` | Product references | Frequently bought together on the product page and suggestions in the cart, set in the Search & Discovery app. |

## Blog posts

| Namespace and key | Type | Where it shows |
| - | - | - |
| `custom.reading_time` | Integer (minutes) | The reading time on blog cards, the blog page and the article. Without it, Kelvin estimates the time from the length of the post (about 220 words a minute). Create it under **Settings → Custom data → Blog posts**. |

## Metaobject: Product review

| Field | Key | Type |
| - | - | - |
| Rating | `rating` | Integer (1 to 5) or rating |
| Title | `title` | Single line text |
| Review | `body` | Multi-line text |
| Author | `author` | Single line text |
| Date | `date` | Date |
| Verified purchase | `verified` | True or false |
| Used for | `used_for` | Single line text |

Create it in **Settings → Custom data → Metaobjects** with the type `customer_review` and the name Product review. See [Product reviews and Verified purchase](https://docs.kwebby.com/kelvin/guides/product-reviews.md).

## Tags

| Tag | Set in | What it does |
| - | - | - |
| `bestseller` | **Theme settings → Badges → Best seller tag** | The Best seller badge. |
| `preorder` | **Theme settings → Badges → Pre-order tag** | Pre-order badge and button, `Pre-order` line property. |
| `pc-part` | **Theme settings → PC Builder → Parts tag** | Add to a PC build on the product page. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.