HomeCollectionsBundlesSettingsDocs

Documentation. This page is ready

Documentation

HouseTech Product Center

    Metafields

    All metafields use the housetech namespace and are written to Shopify during product enrichment. Definitions are auto-created on every app open.

    Product metafields

    Set on the PRODUCT owner. Fields marked optional are only written when the supplier provides a value.


    KeyTypeDescriptionRequired
    housetech.skusingle_line_text_fieldSupplier SKU — the primary identifier for this product.Always
    housetech.eansingle_line_text_fieldEAN / barcode.Optional
    housetech.manufacturer_item_numbersingle_line_text_fieldManufacturer's own item reference number.Optional
    housetech.original_titlesingle_line_text_fieldOriginal supplier title before AI enrichment.Always
    housetech.original_descriptionmulti_line_text_fieldOriginal supplier description before AI enrichment.Always
    housetech.categorysingle_line_text_fieldSupplier category / collection name.Always
    housetech.variantnamestringShort 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_pricenumber_decimalRecommended retail price from supplier.Optional
    housetech.costpricenumber_decimalCost price in DKK.Optional
    housetech.costprice_eurnumber_decimalCost price in EUR.Optional
    housetech.minimum_order_quantitynumber_integerMinimum order quantity.Optional
    housetech.unit_of_measurementsingle_line_text_fieldUnit of measurement (e.g. stk, m²).Optional
    housetech.delivery_timesingle_line_text_fieldDelivery time in days from supplier.Optional
    housetech.freight_typesingle_line_text_fieldFreight type code from supplier.Optional
    housetech.volume_discount_eligiblebooleanAlways true — marks the product as eligible for volume discounts.Always
    housetech.discontinuedbooleanWhether the product has been discontinued by the supplier.Optional
    housetech.discontinued_datedateDate of discontinuation (YYYY-MM-DD).Optional
    housetech.specific_delivery_datesingle_line_text_fieldFree-text delivery notice from the supplier, e.g. "Dag-til-dag levering".Optional
    housetech.dimension_widthdimensionWidth as a Shopify dimension object { value, unit }.Optional
    housetech.dimension_heightdimensionHeight as a Shopify dimension object { value, unit }.Optional
    housetech.dimension_lengthdimensionLength as a Shopify dimension object { value, unit }.Optional
    housetech.dimension_weightweightWeight as a Shopify weight object { value, unit }.Optional
    housetech.volume_dimensionsnumber_decimalComputed volume: W × H × L. Only present when all three spatial dimensions exist.Optional
    housetech.customsinformation_originsingle_line_text_fieldCountry of origin (e.g. DK, CN).Optional
    housetech.customsinformation_hscodesingle_line_text_fieldHS / tariff code for customs.Optional
    housetech.customsinformation_unspcscodesingle_line_text_fieldUNSPSC classification code.Optional
    housetech.spec_[name]boolean | number_integer | number_decimal | single_line_text_fieldIndividual 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…jsonFull specifications array chunked into ≤2 MB JSON metafields. Use these when you need the complete spec data.Always

    Additional product metafields

    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 lookups
    • housetech.siblings — list.product_reference — Related products that were previously grouped as variants but are now separate Shopify products
    • housetech.accessories — list.product_reference — Accessory products recommended for use with this product
    • housetech.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 references

    Collection metafields

    Set 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 tiers
    • housetech.collection_image_visible — boolean — Set to true on all collections created by the app
    • housetech.subcollection — boolean — Set to true on FilterType subcollections (not category-level collections)

    Shop metafields

    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 app

    Metaobject types

    Custom metaobject definitions used by the app. Referenced via metafields above.

    • volume_discount — name (text), discount_tiers (json), profit_margin (number_decimal) — Volume discount presets managed in the app and assigned per collection
    • datasheet — filename (text), group (text), type (text), file (file_reference), link (url) — Product datasheets/PDFs
    • bundle_item — quantity (number_integer), products (list.product_reference) — Individual bundle components
    • filter — name (text), spec_name (text) — A single filterable specification mapped to a display name
    • filter_group — name (text), filters (list.metaobject_reference → filter) — A named group of filters for use in storefront faceted navigation