WooCommerce · Schema

AddCartItemInput

Input for adding an item to the cart.

eCommerceOpen SourceOrdersProductsWordPress

Properties

Name Type Description
id integer Product ID to add.
quantity integer Quantity to add.
variation_id integer Variation ID for variable products.
variation array Attribute key-value pairs for the variation.
item_data array Additional custom item data.
View JSON Schema on GitHub

JSON Schema

woocommerce-store-api-add-cart-item-input-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/woocommerce/refs/heads/main/json-schema/woocommerce-store-api-add-cart-item-input-schema.json",
  "title": "AddCartItemInput",
  "description": "Input for adding an item to the cart.",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Product ID to add.",
      "example": 1
    },
    "quantity": {
      "type": "integer",
      "description": "Quantity to add.",
      "minimum": 1,
      "example": 1
    },
    "variation_id": {
      "type": "integer",
      "description": "Variation ID for variable products.",
      "example": 1
    },
    "variation": {
      "type": "array",
      "description": "Attribute key-value pairs for the variation.",
      "items": {
        "type": "object",
        "properties": {
          "attribute": {
            "type": "string",
            "description": "Attribute name."
          },
          "value": {
            "type": "string",
            "description": "Selected attribute value."
          }
        }
      },
      "example": [
        {
          "attribute": "string-value",
          "value": "string-value"
        }
      ]
    },
    "item_data": {
      "type": "array",
      "description": "Additional custom item data.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Data key name."
          },
          "value": {
            "type": "string",
            "description": "Data value."
          }
        }
      },
      "example": [
        {
          "name": "Example Name",
          "value": "string-value"
        }
      ]
    }
  },
  "required": [
    "id",
    "quantity"
  ]
}