> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# addShoppingListItems

GraphQL MUTATION

Add products to a shopping list. Adding an item that already exists (same product, variant and options) increases its quantity.

**Deprecated:** Alpha version. Do not use in production.

Reference: https://docs.bigcommerce.com/developer/api-reference/graphql/storefront/mutations/company/add-shopping-list-items

## GraphQL Schema

```graphql
mutation ExampleMutation($input: AddShoppingListItemsInput!) {
  company {
    addShoppingListItems(input: $input) {
      entityIds
      errors
    }
  }
}
```

## Variables

```json
{
  "input": {
    "shoppingListEntityId": 0,
    "items": [
      {
        "productEntityId": 0,
        "variantEntityId": 0,
        "quantity": 0,
        "selectedOptions": {
          "multipleChoices": [
            {
              "optionEntityId": 0,
              "optionValueEntityId": 0
            }
          ],
          "checkboxes": [
            {
              "optionEntityId": 0,
              "optionValueEntityId": 0
            }
          ],
          "textFields": [
            {
              "optionEntityId": 0,
              "text": "example"
            }
          ],
          "multiLineTextFields": [
            {
              "optionEntityId": 0,
              "text": "example"
            }
          ],
          "numberFields": [
            {
              "optionEntityId": 0,
              "number": 0
            }
          ],
          "dateFields": [
            {
              "optionEntityId": 0,
              "date": "2026-11-13T19:25:24.514Z"
            }
          ]
        },
        "sortOrder": 0,
        "productNote": "example"
      }
    ]
  }
}
```