# Every field on the material form

> A reference of every field on the create and edit material form, which ones are required, and what each one feeds into.

Source: https://docs.vestislabs.com/library/material-form-fields/

This page lists every field of the material form, in the order they appear. The same form is used to [create a material](https://docs.vestislabs.com/library/create-digital-material-library/) and to [edit one](https://docs.vestislabs.com/library/material-detail-and-edit/). A few fields exist on only one of the two, and the table says so.

**Where to find it:** Library → Materials → New (or open a material → Details)

**Requires:** permission `UPDATE_PRODUCT,VIEW_PRODUCT`

## How to read the form

- A red mark next to a label means the field is required for this form.
- A small **DPP** badge next to a label means the field is relevant for Digital Product Passport readiness. The switch above the form turns these badges on or off for your whole brand.
- The **i** icon next to most labels opens a short explanation.

## Header and images

| Field | Required | What it does |
| --- | --- | --- |
| **Library Type** | No | **Private** (visible only to your brand) or **Public** (available to all brands inside Vestis Labs). The options you see follow your private and public library permissions. Choosing **Public** asks you to confirm in the **Make Library Public** dialog. |
| **Material Images** | No | Upload one or more pictures (.jpeg, .jpg, .png or .svg, up to 3 MB each). From a picture's menu you can set it as default, download it or delete it. The default image is the cover in the library, in styles and BOMs, and in the Digital Product Passport. |
| **Invited Users** | No | Users who can access this material. Shown only when material invitations are turned on for your brand. Use **Add User** to search and select users, and the cross on an avatar to remove one. |
| **Created By** | n/a | The user who created the material. Edit form only, and only when material invitations are turned on. |

## Identity

| Field | Required | What it does |
| --- | --- | --- |
| **Name** | Yes | The name used across your library, collections, styles and BOMs. It is also shown publicly in the Digital Product Passport. "Name must not be empty" appears if it is blank. |
| **Code (SKU)** | Yes | Your supplier's identifier for the material. It flows into BOMs, costings, tech packs and the Digital Product Passport. "Code must not be empty" appears if it is blank. On the edit form this field is labelled **Supplier Code (SKU)**. |
| **Material Code** | No | Your own code for the material. Edit form only. |
| **Category** | No | The broad group, such as fabric, trim, label or packaging. Select one, or type a new name to create it. Categories are also managed in [Library category settings](https://docs.vestislabs.com/settings/library-category-settings/). |
| **Description** | No | A short free-text description. |

## Composition and dimensions

| Field | Required | What it does |
| --- | --- | --- |
| **Compositions** | No | Click **Add Composition**. Each row has a **Composition** (required in a row you add), a **%** and a **Material Category**. When some rows belong to a recycled category, a badge shows the total, for example **20% Recycled Content**. Compositions are also managed in [Composition settings](https://docs.vestislabs.com/settings/composition-setting/). |
| **Weight** | No | A number and a **Weight unit**. |
| **Width** | No | A number and a **Width unit**. |
| **Length** | No | A number and a **Length unit**. |
| **Thickness** | No | A number and a **Thickness unit**. |

Units come from your brand's dimension list. Type a new unit in a unit dropdown to create it. See [Dimension settings](https://docs.vestislabs.com/settings/dimension-settings/).

## Price and costs

| Field | Required | What it does |
| --- | --- | --- |
| **Price** | No | Shows the current price, or the quantity breaks, with a **Set pricing** button (**Edit pricing** on the edit form). The dialog also holds the **Currency** and **Price unit**. See [Set quantity-break pricing for a material](https://docs.vestislabs.com/library/material-price-tiers/). |
| **Exchange Rate** | No | Pick one of the exchange rates managed under Settings. Useful when suppliers quote in other currencies. |
| **Additional costs/surcharges** | No | Extra charges such as freight or dyeing. Choose a **Method**, **Value** (a fixed amount) or **%** (a percentage of the price), then enter the amount. In **%** mode the value is calculated for you. Use a negative value for a discount. |
| **Total Costs** | n/a | Read-only. The price plus the additional costs, in the same currency and unit. It is what BOMs and style costings use. |

## Colours, MOQ and finish

| Field | Required | What it does |
| --- | --- | --- |
| **Colors** | No | Click **Add Color**, then **From Library** to pick from your colour palette or **Custom Color** to enter one by hand. Each colour has a **Code**, a **Pantone Code** and a **Name**. The **Name** is required ("Color name must not be empty"). A badge shows **Color Library** or **Custom Color**. Each colour has a menu with **Edit Color Library** (for colours from your palette) and **Delete**, which asks you to confirm in **Delete Library Color**. |
| **MOQ** | No | The smallest quantity your supplier accepts, with an **MOQ unit**. |
| **Construction** | No | Structural details of the material. |
| **Finishing** | No | Finishing details such as brushing or washing. |
| **Care Instructions** | No | Click **Add Instruction** and select one of your care instructions. Drag the handle to reorder, or delete a row from its menu. Care instructions are managed in [Care instruction management](https://docs.vestislabs.com/settings/care-instruction-management/). |
| **Attributes** | No | Click **Add Attribute**, pick a **Product Attribute Master** and a **Product Attribute**, then click **Add**. The same attribute cannot be added twice ("You have already added this attribute"). |

## Media, suppliers and files

| Field | Required | What it does |
| --- | --- | --- |
| **Media** | No | Click **Add Media**, then **From file**, **From URL** or **From YouTube**. Each row needs a **Media title**. A file row adds **Media file** with an **Upload media** button; a link row asks for a **Media URL**; a YouTube row asks for a **Media Youtube Embed URL**. |
| **Supplier/Factory** | No | Choose a **Tier** and a **Supplier/Factory**. Type a new name in either dropdown to create it. The three dots next to the pair offer **View/Edit Supplier**. |
| **Additional Tier Suppliers** | No | Click **Add Tier Supplier** to link more upstream suppliers. Each row has a **Product / Service**, a **Tier** and a **Supplier**. |
| **Memo** | No | Internal notes, usage details or test results. |
| **Attach file** | No | Click **Add Attachment**, then **Upload attachment**. Rows can be downloaded, changed or deleted from their menu. |

## Edit form only

| Field | What it does |
| --- | --- |
| **Request Sample** | A button above the fields. It offers **Request Sample** and **Request Lab Dip**, each asking you to pick a colour and click **Submit**. Shown only when sampling is turned on and you can create samples. |
| **Request Lab Dip** on a colour | In a colour's menu, pick the colour and click **Submit** to request a lab dip for just that colour. Shown only when sampling is turned on. |

> [!NOTE]
> Certificates are not part of this form. Link them from the material's **Certificates** tab, see [Material certificates](https://docs.vestislabs.com/library/material-certificates/).