# Shipment

The `shipment` object represents a shipment for an order, including addresses, carrier, packages, and tracking information.

## Usage Example

```liquid
{%- comment -%} Show shipment details and tracking {%- endcomment -%}
<h2>Shipment: {{ shipment.title }}</h2>
<p>Carrier: {{ shipment.carrier }} ({{ shipment.carrier_product }})</p>
<p>Created at: {{ shipment.created_at | date: '%Y-%m-%d' }}</p>
<p>Tracking: {% if shipment.tracking_url %}<a href="{{ shipment.tracking_url }}">{{ shipment.tracking_code }}</a>{% else %}N/A{% endif %}</p>
<ul>
  {% for package in shipment.packages %}
    <li>{{ package.description }} ({{ package.weight }}g, {{ package.length }}x{{ package.width }}x{{ package.height }} cm)</li>
  {% endfor %}
</ul>
```

## Properties

### address

Returns the shipping [address](/reference/liquid/objects/store/address/) for this shipment.

### carrier

Returns the carrier name.

### carrier_product

Returns the carrier product name.

### created_at

Returns the date when this shipment was created.

### description

Returns the description for this shipment, if any.

### packages

Returns information about shipment packages, including:

-   description
-   width (in cm)
-   height (in cm)
-   length (in cm)
-   weight (in grams)
-   items
-   shipped_quantity
-   [line_item](/reference/liquid/objects/store/order_line_item/)
-   tracking_url (if defined)
-   tracking_code (if defined)

### pickup_address

Returns the pickup [address](/reference/liquid/objects/store/address/) if any.

### title

Returns the title for this shipment, usually carrier name and product name combined.

### tracking_code

Returns the tracking code for this shipment. For multiparcel shipments, the first available package tracking code is returned.

### tracking_url

Returns the tracking URL for this shipment. For multiparcel shipments, the first available package tracking URL is returned.