> For the complete documentation index, see [llms.txt](https://help.supplyd.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.supplyd.co/supplyd-erp/sales/creating-sales-orders/adding-meta-data.md).

# Adding Meta Data

Using Meta Data helps keep order-specific requirements organised and recorded against the relevant product without changing the product's standard details in Supply’d.

**Meta Data** in Supply’d allows you to record additional information or specific customer requirements against individual sales order items, such as colours, flavours, sizes or special instructions. This information is stored separately from the product's standard details, allowing you to customise individual orders without changing the original product information.

Using Meta Data helps ensure customer requirements are clearly recorded, making it easier for staff to prepare and fulfil orders accurately.

{% hint style="success" %}
**What is Meta Data?**

**Meta Data** is additional information that can be stored against an individual item in a sales order. It allows you to record specific details or customer requirements that are not included in the standard product information.<br>

Meta Data is stored as a **key and value pair**, where:<br>

* **Key** – Identifies the type of information being recorded, such as Colour, Flavour or Size.
* **Value** – Specifies the information associated with that key, such as Blue, Chocolate or Large.<br>

For example, if a customer orders a **5 Pack of Boxed Chocolates** and wants to choose their own flavours, you can use Meta Data to record each selection. You could enter **1st Flavour** as the key and **Raspberry** as the value, **2nd Flavour** as the key and **Caramel** as the value, and so on until all five flavours have been recorded.

This allows you to capture the customer's specific requirements without changing the original product details in Supply’d.<br>
{% endhint %}

This document will guide you through the process of adding and editing **Meta Data** for individual sales order items in Supply’d, including how to enter additional information and view the details recorded against an order item.

* [#adding-or-editing-meta-data](#adding-or-editing-meta-data "mention")
* [#example-chocolate-bonbon-selection](#example-chocolate-bonbon-selection "mention")

***

## Adding or Editing Meta Data

{% stepper %}
{% step %}

#### Select Edit Meta Data

Before creating an order or when editing an order, click the three dots to the right of an order item and select **Edit Meta Data**.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FRVtOfsTsdVteSnMSAJIl%2FSales%20Item%203%20Dot%20-%20Edit%20Meta%20Data.png?alt=media&amp;token=da520273-5259-43e6-bb6c-c51299ea6c13" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

The **Edit Meta Data** form will open, allowing you to add or update additional information for a specific item in a sales order.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FFrblnag0hA37k3bZbGwY%2FEdit%20Meta%20Form.png?alt=media&amp;token=347492ba-cd7b-4a6e-881d-ae2b8d3e2576" alt="" width="563"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
👉 See the [Creating Sales Orders](https://help.supplyd.co/supplyd-erp/sales/creating-sales-orders.md) documentation for details on creating sales orers.

👉 See [Editing a Sales Order](https://help.supplyd.co/supplyd-erp/sales/managing-sales-orders/editing-a-sales-order.md) for details on editng a sales order.
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Click Add Meta Field

Click <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FwekDMaKcKZ6JgQYG8CbK%2FAdd%20Meta%20Field.jpg?alt=media&amp;token=75093614-9840-4d7b-9726-a72f37ac606e" alt="" data-size="line"> to add the first set of **Meta Key** and **Meta Value** fields.&#x20;

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FilP7FlyuTRSmePXLDlBU%2FAdd%20Meta%20Field.png?alt=media&amp;token=60bca05b-83e2-4b61-be52-cc85de3e8524" alt="" width="563"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

**Meta Key**

Enter a name that identifies the information being recorded, such as *Flavour*, *Colour* or *Size*. Each **Meta Key** must be unique within the individual order item.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

**Meta Value**

Enter the specific information associated with the **Meta Key**. For example, if the **Meta Key** is *1st Flavour*, the **Meta Value** could be *Raspberry*.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Tip:** Use clear, descriptive **Meta Keys** so that other staff members can easily understand the information recorded against the order item.
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Repeat Step 2

Click <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FwekDMaKcKZ6JgQYG8CbK%2FAdd%20Meta%20Field.jpg?alt=media&amp;token=75093614-9840-4d7b-9726-a72f37ac606e" alt="" data-size="line"> to add the next set of **Meta Key** and **Meta Value** fields.&#x20;

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

Repeat this process to record each flavour selection separately.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
To remove a set of **Meta Key** and **Meta Value** fields, click the **X** to the right of the key name in the blue heading.

<p align="center"><br><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FMjNNbeaPoAZT3O1EyPSh%2FRemove%20Key.png?alt=media&amp;token=451e3808-ebb7-45ab-a364-b148c00c7e86" alt="" data-size="original"><br></p>
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Click Save

Once you have entered or updated all the required information, click <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2Fw7vNdWre4ViL4czC3qLv%2FSAVE.png?alt=media&amp;token=96a25e18-5d77-4c97-82c6-d9d9d6362740" alt="" data-size="line"> to save the Meta Data against the selected order item.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

Each flavour is recorded as a separate **Meta Field**, making it easy to identify exactly which flavours the customer has requested.

The Meta Data will appear against the relevant item on the sales order, allowing staff to refer to these details when preparing or fulfilling the order.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}

***

## Example – Chocolate Bonbon Selection

A customer orders a five-pack of chocolate bonbons and wants to choose five different flavours.

Rather than creating separate products for each flavour combination, you can use Meta Data to record the customer's selections against the order item.

Enter the following information for each of the five flavours:

| Meta Key  | Meta Value |
| --------- | ---------- |
| Flavour 1 | Raspberry  |
| Flavour 2 | Caramel    |
| Flavour 3 | Hazelnut   |
| Flavour 4 | Strawberry |
| Flavour 5 | Vanilla    |

{% stepper %}
{% step %}

#### Click Add Meta Field

Click <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FwekDMaKcKZ6JgQYG8CbK%2FAdd%20Meta%20Field.jpg?alt=media&amp;token=75093614-9840-4d7b-9726-a72f37ac606e" alt="" data-size="line"> to add the first set of **Meta Key** and **Meta Value** fields.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FYPL2Ij4F37mL7Rkbg4C2%2FKey%20%26%20Value.png?alt=media&amp;token=03e9286f-7e85-47f3-b9d5-56907420a2f3" alt="" width="563"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

* **Meta Key** - Flavour 1
* **Meta Value** - Raspberry

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Repeat Step 1

Click <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FwekDMaKcKZ6JgQYG8CbK%2FAdd%20Meta%20Field.jpg?alt=media&amp;token=75093614-9840-4d7b-9726-a72f37ac606e" alt="" data-size="line"> again to add the next set of **Meta Key** and **Meta Value** fields.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FFD4nC7QJbaiNP9uG48an%2FKey%20%26%20Value%202.png?alt=media&amp;token=4eaebc16-e2b7-4307-a6c5-5ec714923a2b" alt="" width="563"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

* **Meta Key -** Flavour 2
* **Meta Value -** Caramel

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

Repeat this process until all five flavours have been added, ensuring each flavour has its own **Meta Key** and **Meta Value**.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Click Save

Once you have entered or updated all the required information, click <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2Fw7vNdWre4ViL4czC3qLv%2FSAVE.png?alt=media&amp;token=96a25e18-5d77-4c97-82c6-d9d9d6362740" alt="" data-size="line"> to save the Meta Data against the selected order item.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FiBlWMba1iqRFCTZhExL7%2FOrder%20Items%20-%20Hover%20Meta%20.png?alt=media&amp;token=f7cdd286-ca89-4429-9dc7-9cf4676b6d83" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}


---

# 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://help.supplyd.co/supplyd-erp/sales/creating-sales-orders/adding-meta-data.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.
