Product metafields
Metafields let you add structured data per product — specifications, key facts, ingredients, how-to-use instructions — without cluttering the description.
Citera uses these to power specific blocks on the product page: Key facts, Specifications, and Collapsible rows can all read from metafields.
The Citera metafield conventions
Create these under Settings → Custom data → Products in your Shopify admin, then fill them per product. Empty metafields fall back to shared section content, so nothing breaks.
| Namespace · key | Type | Fills which block | Format |
|---|---|---|---|
custom.specs | List · single-line text | Specifications table | Name: Value per entry — e.g. Serving size: 2 capsules |
custom.directions | Multi-line text | ”How to use” row | Plain text |
custom.key_facts | List · single-line text | Key facts list | One short fact per entry |
custom.ingredients | Multi-line or rich text | Ingredients row | Your ingredient statement |
Create a metafield (example: Specifications)
Go to Shopify admin → Settings → Custom data
Click Products
Click Add definition
Fill in
- Name: Specifications
- Namespace and key:
custom.specs - Description (optional): “Product specifications shown on the product page”
- Type: List → Single line text
Save
Fill it per product
Shopify admin → Products → [pick a product]
Scroll to Metafields
You’ll see “Specifications” in the list.
Click and add entries
Each entry follows Name: Value format:
Serving size: 2 capsulesServings per container: 30Contains: Vitamin D3, K2, MCT oil
Add as many as you need. The Specifications block on the product page renders each as a row in a name-value table.
Save
Any collapsible row can read a metafield
The Collapsible row block on the product page has a Metafield namespace and key setting. Point it to any metafield:
Click a Collapsible row block on the product page
Set Metafield namespace = custom
Set Metafield key = directions (or your own key)
Fallback content
If a product has no value for that metafield, the row shows whatever text you typed in the block. So the row always has content — filled products show per-product data, empty products show the fallback.
Bulk-edit metafields. Use Shopify’s bulk editor (or Matrixify) to fill metafields across many products at once — faster than product-by-product.
Custom metafields (any namespace, any key)
You’re not limited to Citera’s conventions. Create any metafield you want:
custom.certificationscustom.origin_countrycustom.eco_score
Then use the Metafield block on the product page to render it. Pick the namespace and key, and Citera outputs the value.