Documentation. This page is ready
HouseTech Product Center
All metafields use the housetech namespace and are written to Shopify during product enrichment. Definitions are auto-created on every app open.
Set on the PRODUCT owner. Fields marked optional are only written when the supplier provides a value.
| Key | Type | Description | Required |
|---|---|---|---|
| housetech.sku | single_line_text_field | Supplier SKU — the primary identifier for this product. | Always |
| housetech.ean | single_line_text_field | EAN / barcode. | Optional |
| housetech.manufacturer_item_number | single_line_text_field | Manufacturer's own item reference number. | Optional |
| housetech.original_title | single_line_text_field | Original supplier title before AI enrichment. | Always |
| housetech.original_description | multi_line_text_field | Original supplier description before AI enrichment. | Always |
| housetech.category | single_line_text_field | Supplier category / collection name. | Always |
| housetech.variantname | string | Short display name for the sibling/variant selector (e.g. "43" or "82C56") shown instead of the full product title. Maintained on the product itself — not in the variants array. Send empty/null to remove. | Optional |
| housetech.list_price | number_decimal | Recommended retail price from supplier. | Optional |
| housetech.costprice | number_decimal | Cost price in DKK. | Optional |
| housetech.costprice_eur | number_decimal | Cost price in EUR. | Optional |
| housetech.minimum_order_quantity | number_integer | Minimum order quantity. | Optional |
| housetech.unit_of_measurement | single_line_text_field | Unit of measurement (e.g. stk, m²). | Optional |
| housetech.delivery_time | single_line_text_field | Delivery time in days from supplier. | Optional |
| housetech.freight_type | single_line_text_field | Freight type code from supplier. | Optional |
| housetech.volume_discount_eligible | boolean | Always true — marks the product as eligible for volume discounts. | Always |
| housetech.discontinued | boolean | Whether the product has been discontinued by the supplier. | Optional |
| housetech.discontinued_date | date | Date of discontinuation (YYYY-MM-DD). | Optional |
| housetech.specific_delivery_date | single_line_text_field | Free-text delivery notice from the supplier, e.g. "Dag-til-dag levering". | Optional |
| housetech.dimension_width | dimension | Width as a Shopify dimension object { value, unit }. | Optional |
| housetech.dimension_height | dimension | Height as a Shopify dimension object { value, unit }. | Optional |
| housetech.dimension_length | dimension | Length as a Shopify dimension object { value, unit }. | Optional |
| housetech.dimension_weight | weight | Weight as a Shopify weight object { value, unit }. | Optional |
| housetech.volume_dimensions | number_decimal | Computed volume: W × H × L. Only present when all three spatial dimensions exist. | Optional |
| housetech.customsinformation_origin | single_line_text_field | Country of origin (e.g. DK, CN). | Optional |
| housetech.customsinformation_hscode | single_line_text_field | HS / tariff code for customs. | Optional |
| housetech.customsinformation_unspcscode | single_line_text_field | UNSPSC classification code. | Optional |
| housetech.spec_[name] | boolean | number_integer | number_decimal | single_line_text_field | Individual specification value. Key is prefixed with spec_ and the spec name lowercased/underscored (max 64 chars). Type is auto-detected from the value. | Always |
| housetech.specifications_0, _1, _2… | json | Full specifications array chunked into ≤2 MB JSON metafields. Use these when you need the complete spec data. | Always |
Set on the PRODUCT owner. These are managed separately from the enrichment pipeline.
housetech.internal_id — id — Handleized SKU used as a stable identifier for idempotent lookupshousetech.siblings — list.product_reference — Related products that were previously grouped as variants but are now separate Shopify productshousetech.accessories — list.product_reference — Accessory products recommended for use with this producthousetech.datasheets — list.metaobject_reference → datasheet — List of datasheet metaobjects (filename, group, type, file, link)housetech.bundle — list.metaobject_reference → bundle_item — Bundle components, each with a quantity and list of product referencesSet on the COLLECTION owner.
housetech.internal_id — id — Handleized collection title. Used for fast O(1) collection lookups via collectionByIdentifier (avoids Shopify search API issues with Danish characters)housetech.volume_discount — metaobject_reference → volume_discount — Volume discount preset assigned to this collection. The storefront reads this to display volume pricing tiershousetech.collection_image_visible — boolean — Set to true on all collections created by the apphousetech.subcollection — boolean — Set to true on FilterType subcollections (not category-level collections)Set on the SHOP owner.
housetech.bundle_discounts — json — Array of bundle pricing tiers: [{ "priceFrom": 0, "priceTo": 500, "discountPercent": 5 }, ...]. Updated whenever bundle pricing tiers are saved in the appCustom metaobject definitions used by the app. Referenced via metafields above.
name (text), discount_tiers (json), profit_margin (number_decimal) — Volume discount presets managed in the app and assigned per collectionfilename (text), group (text), type (text), file (file_reference), link (url) — Product datasheets/PDFsquantity (number_integer), products (list.product_reference) — Individual bundle componentsname (text), spec_name (text) — A single filterable specification mapped to a display namename (text), filters (list.metaobject_reference → filter) — A named group of filters for use in storefront faceted navigation