WooCommerce Product Add-ons Support

WooGraphQL Pro provides complete GraphQL support for WooCommerce Product Add-ons, enabling customizable product options in your headless storefront.

• WooCommerce Product Add-ons 6.0+
• Add-ons must be enabled in WooGraphQL Pro settings (product_addons)

8 field types are supported:

Add-ons support multiple pricing methods:

• Flat Fee - Fixed price addition
• Quantity Based - Price per unit
• Percentage Based - Percentage of product price

• Add products with add-on selections
• Prices automatically calculated
• Add-on data stored in cart item metadata

query GetProductWithAddons($id: ID!) {
  product(id: $id, idType: DATABASE_ID) {
    id
    name
    price
    addons {
      fieldName
      name
      type
      required
      price
      priceType

      ... on AddonMultipleChoice {
        choiceType
        options {
          label
          price
          priceType
          image {
            sourceUrl
          }
        }
      }

      ... on AddonShortText {
        restrictions
        characterLimit {
          min
          max
        }
      }

      ... on AddonCheckbox {
        options {
          label
          price
          priceType
        }
      }
    }
  }
}

mutation AddToCartWithAddons($productId: Int!, $addons: [ProductAddonInput!]) {
  addToCart(
    input: {
      productId: $productId
      quantity: 1
      addons: $addons
    }
  ) {
    cart {
      total
    }
    cartItem {
      key
      quantity
      total
      extraData {
        key
        value
      }
    }
  }
}

Variables:

{
  "productId": 123,
  "addons": [
    {
      "fieldName": "addon_123_engraving",
      "value": ["Custom Text Here"]
    },
    {
      "fieldName": "addon_123_gift_wrap",
      "value": ["Yes"]
    }
  ]
}

WooGraphQL Pro provides mutations for managing global product addon groups:

• createGlobalProductAddon - Create a global addon group
• updateGlobalProductAddon - Update an existing group
• deleteGlobalProductAddon - Delete a group

See the Mutations Reference for full details.

All product CRUD mutations (createProduct, updateProduct, createBundleProduct, createSubscriptionProduct, createCompositeProduct, and their update variants) accept:

See the Mutations Reference for input type details.

• Field Types - All addon field types and their properties
• Cart Integration - Adding products with add-ons

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