# Product List

## Overview

You can display an product lists in your customer emails and on your <code class="expression">space.vars.Product\_OrderStatus</code> after a customer has placed an order, based on the order and product information you send to parcelLab.

{% hint style="info" %}
If you provide a link to your online shop, parcelLab can forward the customer to the shop’s webpage when they click a purchased product.
{% endhint %}

<div align="left"><figure><img src="https://1156682959-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPf1Lv1YUuLYva6LrXQ%2Fuploads%2FWPkw1fTj4Dk2FdmOenXq%2FParkersArticleListHighlight.png?alt=media&#x26;token=f835ddbd-765c-48ba-9378-1de755661751" alt="Email with list of purchased products" width="375"><figcaption></figcaption></figure></div>

## Configuring the Product List Feature

The following sections describe the configuration required for the Product List feature.

### Customer Requirements

To integrate purchased products in email communication, you need to provide the following information to parcelLab:

* The relevant product data and images (or a path to an image) of an order before dispatch communication via the parcelLab data integration.
* In which emails to display the content (for example: out for delivery emails).
* A URL to forward the customer to your online shop when they click the purchased products.

{% hint style="info" %}
Product-specific URLs can be included in the list of purchased products (that is: clicking on the product will direct customers to the product’s page in the online shop).
{% endhint %}

## Implementation Process

When parcelLab has the required information, the setup process can begin.

#### Article Lists in Emails

The article list in the emails has different detail levels. A simple list only features article numbers, names, and quantities.

As described in the data model, the article list has to be transmitted when creating a `tracking`. The following example shows how an article list is structured.

{% code title="article-list.json" %}

```javascript
[
  {
    articleNo:        'article number (String)',            // required
    articleName:      'article name (String)',              // required
    quantity:         Integer,                              // optional
  },
  ...
]
```

{% endcode %}

The more detailed article list features an image per row and links back to the product page within the shop. For the system to show this article list, the simple article list must be transmitted for every `tracking`.

<div align="left"><figure><img src="https://1156682959-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPf1Lv1YUuLYva6LrXQ%2Fuploads%2Ft1P6yDX6s1nNGeLSkmZO%2FParkersArticleListDetailed.png?alt=media&#x26;token=b4bbba77-0546-4304-88d5-822c183fb0a4" alt="Detailed article list" width="375"><figcaption><p>Detailed article list</p></figcaption></figure></div>

Extending the article list can be achieved through one of the following ways:

* Add the `articleUrl` and `articleImageUrl` parameters to each object of the `articles` array to extend the transmitted article list.

{% hint style="info" %}
However, in most cases this is *not* possible as the warehouse software generating the shipment labels does not have these detailed information related to the shop articles.
{% endhint %}

* Import product feeds to extend the data in the article list, which is supported by parcelLab.

{% hint style="info" %}
A product feed is a complete article master list, which is formatted as a .csv file and can be accessed via HTTPS. It contains the article number provided when creating the tracking and information that should be extended on a per-article basis (for example: article name, product page URL, and product image URL (thumbnail)).
{% endhint %}

#### Article Lists on the Order Status Page

When article lists are configured, an order summary is displayed on the right-hand side of the <code class="expression">space.vars.Product\_OrderStatus</code>.

{% hint style="info" %}
For further information, see [how article lists are configured on the Order Status page](https://app.gitbook.com/s/m5MUhYrMmT0cei4QdxGn/status-updates/configuration#article-lists).
{% endhint %}

<figure><img src="https://1156682959-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPf1Lv1YUuLYva6LrXQ%2Fuploads%2F0qoKNXhVvl5jXPiyyEV2%2FParkersArticleListOSPage.png?alt=media&#x26;token=b0337675-3add-4c03-8e32-237c4ba91a0b" alt="Order status page with order summary"><figcaption><p>Order Status page with purchased products</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.parcellab.com/docs/engage/messages-and-journeys/overview/article-lists.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.