WooCommerce Composite Products Support

WooGraphQL Pro provides complete GraphQL support for WooCommerce Composite Products, enabling you to build headless storefronts with sophisticated configurable products.

• WooCommerce Composite Products 8.0+
• Composites must be enabled in WooGraphQL Pro settings (composite_products)

Query and display composite products with:

• Multi-component product configurations
• Conditional scenarios for dynamic behavior
• Multiple layout options (stacked, progressive, stepped)
• Flexible pricing models

Access component configuration including:

• Product/category-based option queries
• Quantity constraints (min/max)
• Optional component flags
• Individual pricing and discounts
• Display style options (dropdown, thumbnails, radio)

Conditional logic support:

• Dynamic component visibility
• Option filtering based on selections
• Complex multi-condition rules

Add composites to cart with full configuration:

• Component-level product selection
• Variation selection for variable products
• Quantity specification per component
• Custom data support

query GetCompositeProduct($id: ID!) {
  product(id: $id, idType: DATABASE_ID) {
    ... on CompositeProduct {
      id
      name
      price
      layout
      editableInCart

      components {
        componentId
        title
        description
        optional
        pricedIndividually
        minQuantity
        maxQuantity
        defaultQuantity
        discount
        optionsStyle

        queryOptions {
          nodes {
            id
            name
            price
          }
        }

        defaultOption {
          id
          name
        }
      }
    }
  }
}

mutation AddCompositeToCart(
  $productId: Int!
  $configuration: [CompositeProductConfigurationInput!]!
) {
  addCompositeToCart(
    input: {
      productId: $productId
      quantity: 1
      configuration: $configuration
    }
  ) {
    cart {
      total
    }
    cartItem {
      key
      quantity
      total
      components {
        component {
          title
        }
        productId
        quantity
      }
    }
  }
}

Variables:

{
  "productId": 123,
  "configuration": [
    {
      "componentId": "1",
      "productId": 456,
      "quantity": 1
    },
    {
      "componentId": "2",
      "productId": 789,
      "quantity": 2
    }
  ]
}

• Querying Composites - Complete query reference
• Adding Composites to Cart - The addCompositeToCart mutation

• API Types Reference - All composite-related types
• Mutations Reference - Mutation specifications