> For the complete documentation index, see [llms.txt](https://docs.pyck.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pyck.cloud/shopify-app/serial-numbers.md).

# Serial numbers on the order page

Showing the serial numbers pyck shipped on the Shopify order page

Audience: Logistics Manager

If your warehouse records serial numbers when it packs an order, the app can show them on the order in the Shopify admin. A **Serial numbers** card on the order page lists, for each line of the order, the serial numbers that went into the parcel. Your team can then answer a customer's warranty or return question in Shopify, without looking the order up in pyck.

The card only shows serial numbers. You cannot edit them in the card. pyck fills them in when the order is packed.

## Add the card to the order page

The card comes with the app, but Shopify does not put it on the order page by itself. Someone with access to the store's admin adds it once per store:

1. Open any order in the Shopify admin.
2. Click **Blocks**, then **+ Block**.
3. Choose **Serial numbers**.
4. Click **Pin to page for all staff**, so everyone sees the card on every order, not just you.

From then on the card appears on every order, including orders that were packed before you added it.

## What the card shows

* **One entry per order line that has serial numbers**, in the same order as the lines of the order. Each entry is headed with the product title, the SKU and the quantity ordered, for example "Barcode scanner · NBCGE-1000 × 2", followed by its serial numbers, separated by commas.
* **Lines without serial numbers are left out.** A product your warehouse does not track by serial number does not appear in the card.
* **A line that was removed from the order after packing** still shows its serial numbers, headed with its SKU and "Line no longer on the order". That way an order edit never hides what was actually shipped.
* **When the card is collapsed**, it shows the total, for example "3 serial numbers", or "None recorded".

The card follows the language of the staff member viewing it. It is available in English and German.

## When the card is empty or shows an error

| What you see                                                                               | What it means                                                                                                                                                                                                                                        |
| ------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "No serial numbers recorded yet", with a note that they are added when the order is packed | The order has not been packed yet, or nothing on it is tracked by serial number. If the order has been packed and should have serial numbers, check with whoever runs your pyck warehouse that serial numbers are recorded and sent back to Shopify. |
| "Couldn't load the serial numbers."                                                        | Shopify could not read the order for the card. Reload the page. If it keeps happening, contact <support@pyck.io>.                                                                                                                                    |
| The card is not on the order page at all                                                   | It has not been added for this store yet, or it was added without **Pin to page for all staff**. See [Add the card to the order page](#add-the-card-to-the-order-page).                                                                              |

## Serial numbers on packing slips and invoices

The serial numbers are stored on the Shopify order in the metafield `pyck.serials`. If you have customised your packing slip or invoice templates, whoever maintains them can print the serial numbers from there too.

## Related

* [Shopify App Overview](https://docs.pyck.cloud/shopify-app/shopify.md) — what travels between Shopify and pyck.
* [When something looks wrong](https://docs.pyck.cloud/shopify-app/troubleshooting.md) — other symptoms and what they mean.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.pyck.cloud/shopify-app/serial-numbers.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
