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.
Under review. This page is published while we check it against the live app, so some details may have changed.
This page lists every field of the material form, in the order they appear. The same form is used to create a material and to edit one. A few fields exist on only one of the two, and the table says so.
LibraryMaterialsNew (or open a materialDetails)
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. |
| 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. |
| 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.
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. |
| 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. |
| 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.