wake-product-variants

Wake Product Variants

Forbidden: api.fbits.net (and any *.fbits.net). Canonical source: https://wakecommerce.readme.io/docs/schema

Variant resolution, attribute matrix, customizations, and subscriptions for Wake Commerce product detail pages and add-to-cart flows.

When to Use

• Building product detail pages with variant selection (e.g. size, color)
• Resolving selectedVariant from user attribute selections
• Handling product customizations (e.g. engraving)
• Supporting subscription products
• Implementing add-to-cart with variants

Core Concepts

attributeSelections(selected)

Pass the user's selected attribute values to resolve the variant:

product(productId: $productId) {
  attributeSelections(selected: $selections) {
    canBeMatrix
    matrix { ... }
    selectedVariant { productVariantId prices { ... } }
    selections { attributeId name values { value selected } }
  }
}

• selections: Array of { attributeId, value } or equivalent per AttributeFilterInput.
• selectedVariant: Resolved when selections match a variant; null when invalid or incomplete.
• matrix: Attribute combinations; use for building variant picker UI. See references/attribute-matrix.md.

selectedVariant

When selectedVariant is non-null, use productVariantId for add-to-cart. When null:

• Selections may be invalid or incomplete
• Product may have no variants (single-variant: use root productVariantId)
• Inform user to complete selection before add-to-cart

customizations

Products may require customizations (e.g. engraving text). Check customizations { customizationId, cost, name, type, values }. When present, include customization values in add-to-cart. See references/customizations.md.

subscriptionGroups

For subscription products, subscriptionGroups { recurringTypes, subscriptionGroupId, subscriptionOnly } defines recurring options. Pass subscriptionGroupId and recurringTypeId when adding subscription to cart.