> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# add_shipping_info Event

> Track when a customer enters their shipping details

Fires when a customer enters their shipping details.

## Example

```javascript theme={null}
window._upstack('track', 'add_shipping_info', {
  // Standard parameters
  value: 69.98,
  currency: 'USD',
  items: [{
    id: '8012345678',
    variant: '44120033',
    variantName: 'Blue / Medium',
    name: 'Classic Cotton Tee',
    sku: 'TEE-BLU-M',
    price: 34.99,
    quantity: 2,
    brand: 'Example Brand',
    category: 'Apparel',
    url: 'https://example.com/products/classic-tee',
    imageUrl: 'https://example.com/images/classic-tee.jpg'
  }],
  shippingTier: 'Standard',
  shipping: 4.99,
  coupon: 'SAVE10',

  // User data
  email: 'jane@example.com',
  phone: '+15551234567',
  firstName: 'Jane',
  lastName: 'Smith',
  addresses: [{
    address1: '123 Main St',
    city: 'Austin',
    provinceCode: 'TX',
    countryCode: 'US',
    zip: '78701'
  }],

  // Custom data
  giftOrder: false,
  pickupInStore: false
});
```

> [!NOTE]
>
> Don't send `transactionId` on this event. It gives the event the same ID as the purchase, and one of them is dropped as a duplicate.

## Standard parameters

| Name | Type | Required | Example value | Description |
| - | - | - | - | - |
| [`value`](https://docs.upstackdata.com/event-tracking/event-taxonomy/properties/value) | `number` | Yes | `69.98` | Cart total. |
| [`currency`](https://docs.upstackdata.com/event-tracking/event-taxonomy/properties/currency) | `string` | Yes | `USD` | ISO 4217 currency code. |
| [`items`](https://docs.upstackdata.com/event-tracking/event-taxonomy/properties/items) | `Array<Item>` | Yes | [See below](#item-parameters) | The products in the event. |
| [`shippingTier`](https://docs.upstackdata.com/event-tracking/event-taxonomy/properties/shipping-tier) | `string` | No | `Standard` | Shipping method chosen. |
| [`shipping`](https://docs.upstackdata.com/event-tracking/event-taxonomy/properties/shipping) | `number` | No | `4.99` | Shipping cost. |
| [`coupon`](https://docs.upstackdata.com/event-tracking/event-taxonomy/properties/coupon) | `string` | No | `SAVE10` | Discount code used. |

## Item parameters

| Name | Type | Required | Example value | Description |
| - | - | - | - | - |
| `id` | `string` | Yes | `8012345678` | Product ID. Must match the ID in your product catalogs. |
| `name` | `string` | Yes | `Classic Cotton Tee` | Product name. |
| `price` | `number` | Yes | `34.99` | Unit price. |
| `quantity` | `number` | Yes | `2` | Quantity. |
| `variant` | `string` | No | `44120033` | Variant ID, not a name. Must match your catalogs. |
| `variantName` | `string` | No | `Blue / Medium` | Variant name. |
| `sku` | `string` | No | `TEE-BLU-M` | SKU. |
| `brand` | `string` | No | `Example Brand` | Brand. |
| `category` | `string` | No | `Apparel` | Product category. |
| `url` | `string` | No | `https://example.com/products/classic-tee` | Product page URL. |
| `imageUrl` | `string` | No | `https://example.com/images/classic-tee.jpg` | Product image URL. |
| `discount` | `number` | No | `3.50` | Discount on this line. |
| `value` | `number` | No | `69.98` | Line total. |
| `content_type` | `string` | No | `product` | `product` or `product_group`. |

## User data

| Name | Type | Required | Example value | Description |
| - | - | - | - | - |
| [`email`](https://docs.upstackdata.com/event-tracking/event-taxonomy/properties/email) | `string` | Yes | `jane@example.com` | Email address. |
| [`phone`](https://docs.upstackdata.com/event-tracking/event-taxonomy/properties/phone) | `string` | Yes\* | `+15551234567` | Phone number in E.164 format. |
| [`firstName`](https://docs.upstackdata.com/event-tracking/event-taxonomy/properties/name) | `string` | Yes\* | `Jane` | First name. |
| [`lastName`](https://docs.upstackdata.com/event-tracking/event-taxonomy/properties/name) | `string` | Yes\* | `Smith` | Last name. |
| [`addresses`](https://docs.upstackdata.com/event-tracking/event-taxonomy/properties/address) | `Array<Address>` | No | [See address parameters](https://docs.upstackdata.com/event-tracking/event-taxonomy/properties/address.md) | Shipping and billing addresses. |

\* Required if you have it.

## Custom data

Examples for this event. See [how custom data works](https://docs.upstackdata.com/event-tracking/event-taxonomy/properties/custom-data.md).

| Name | Type | Example value | Description |
| - | - | - | - |
| `giftOrder` | `boolean` | `false` | Whether the order is a gift. |
| `pickupInStore` | `boolean` | `false` | Whether the customer chose in-store pickup. |

## Related events

* [`initiate_checkout`](https://docs.upstackdata.com/event-tracking/event-taxonomy/standard-events/initiate-checkout) — A visitor starts checkout.
* [`select_shipping_method`](https://docs.upstackdata.com/event-tracking/event-taxonomy/standard-events/select-shipping-method) — A customer chooses a shipping method.
* [`add_payment_info`](https://docs.upstackdata.com/event-tracking/event-taxonomy/standard-events/add-payment-info) — A customer enters their payment details.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.