setGiftOptionsOnCart mutation

The setGiftOptionsOnCart mutation allows the buyer to set the following gift options on the cart level:

• Gift messages
• Gift wrapping
• A gift receipt to accompany the order
• A printed card to accompany the order

Gift messages are a feature of Magento Open Source. All other gift options require Adobe Commerce.

To remove a gift message, set the gift_message object to null. To remove gift wrapping, set the gift_wrapping_id attribute to null.

Use the updateCartItems mutation to set gift messages and gift wrapping on individual items.

These options are configured on the Stores > Configuration > Sales > Sales > Gift Options screen. To determine whether these options are enabled, specify these attributes in the storeConfig query.

• allow_gift_receipt
• allow_gift_wrapping_on_order
• allow_printed_card
• cart_gift_wrapping
• cart_printed_card
• printed_card_price
• sales_gift_wrapping
• sales_printed_card

Gift wrapping is available for simple, configurable, bundle products as well as physical gift cards.

Syntax

mutation: {setGiftOptionsOnCart(input: SetGiftOptionsOnCartInput): SetGiftOptionsOnCartOutput}

Example usage

The following example adds a gift message, gift wrapping, and a gift receipt to the cart.

Request:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
mutation {
  setGiftOptionsOnCart(
    input: {
      cart_id: "8k0Q4MpH2IGahWrTRtqM61YV2MtLPApz"
      gift_message: {
        to: "Alex"
        from: "Veronica"
        message: "Happy Birthday!"
      }
      gift_wrapping_id: "Mg=="
      gift_receipt_included: true
      printed_card_included: false
    }
  ) {
    cart {
      id
      gift_message {
        to
        from
        message
      }
      gift_wrapping {
        uid
      }
      gift_receipt_included
      printed_card_included
      items {
        quantity
        prices {
          price {
            value
            currency
          }
        }
      }
      prices {
        gift_options {
          gift_wrapping_for_order {
            value
            currency
          }
        }
        grand_total {
          value
          currency
        }
      }
    }
  }
}

Response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
{
  "data": {
    "setGiftOptionsOnCart": {
      "cart": {
        "id": "8k0Q4MpH2IGahWrTRtqM61YV2MtLPApz",
        "gift_message": {
            "to": "Alex"
            "from": "Veronica"
            "message": "Happy Birthday!"
        }
        "gift_wrapping": {
          "uid": "Mg=="
        },
        "gift_receipt_included": true,
        "printed_card_included": false,
        "items": [
          {
            "quantity": 1,
            "prices": {
              "price": {
                "value": 32,
                "currency": "USD"
              }
            }
          },
          {
            "quantity": 1,
            "prices": {
              "price": {
                "value": 84,
                "currency": "USD"
              }
            }
          }
        ],
        "prices": {
          "gift_options": {
            "gift_wrapping_for_order": {
              "value": 7,
              "currency": "USD"
            }
          },
          "grand_total": {
            "value": 132.57,
            "currency": "USD"
          }
        }
      }
    }
  }
}

Input attributes

The SetGiftOptionsOnCartInput object can contain the following attributes:

GiftMessageInput

The GiftMessageInput object must contain the following attributes:

Output attributes

The SetGiftOptionsOnCartOutput object contains the Cart object.

Cart object

Cart query output provides more information about the Cart object.

Errors