createAttribute

mutation

Requires commerce.product:write.

Create a new attribute.

Required headers

Header	Required	Description
`x-store-id`	Yes	ID of the store the operation targets. Omitting it returns HTTP 200 with a GraphQL error: `extensions.code: "UNAUTHENTICATED"`.

Go to Authentication for credential setup.

Arguments

input MutationCreateAttributeInput! required
- label String! required
- skuGroupId ID! required
- description String optional
- htmlDescription String optional
- HTMLDescription String optional — Deprecated: Use htmlDescription instead.
- metafields [CreateMetafieldInput!] optional
  - key String! required
  - namespace String! required
  - type String! required — Metafield value type. Live catalog validation accepts lowercase values such as boolean, string, stringMultiLine, number, numberDecimal, date, dateTime, json, measurement, url, reference, money, list.string, list.number, list.numberDecimal. Uppercase STRING is rejected.
  - value String! required
- name String optional
- position Int optional
- values [AssociateAttributeValueInput!] optional
  - label String! required
  - name String optional
  - position Int optional

Possible returns

Attribute Attribute — A SKU is comprised of a combination of multiple attributes

mutation RunCreateAttribute($input: MutationCreateAttributeInput!) {  createAttribute(input: $input) {    id    name    label    createdAt    updatedAt    description  }}

{  "data": {    "createAttribute": {      "id": "ID_VALUE",      "name": "Example",      "label": "Example",      "createdAt": "2026-01-15T12:00:00.000Z",      "updatedAt": "2026-01-15T12:00:00.000Z",      "description": "DESCRIPTION_VALUE"    }  }}

Last updated on