> For the complete documentation index, see [llms.txt](https://kb.bevica.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.bevica.com/documentation/guides/items-and-inventory/user_defined_item_fields.md).

# User Defined Item Fields

Create and use user-defined item fields to store business-specific item attributes.

Bevica lets you define a number of additional item fields. You can decide what they are called and, where they have a lookup, you can decide what values Users can select for each.

* Five **lookup** fields: you can use these, for example, to store an item's List Status (Premium, Normal, Bin End), Organic status, Closure Type, Buyer Code...
* Five **Yes/No** fields: to store, for example, if an item is Vegan, Biodynamic, stored in a Wooden Box...
* Five **number** fields: you can use these, for example, to store PH level, estimated yearly sales...
* Three **date** fields: to store, for example, when the item will be available for sale, released by the supplier...
* Five **text alphanumeric code** fields (30 characters): to hold any additional information not available elsewhere on the item record.

Check the **Item** page itself and **Item Additional Information** page for existing fields you can use before creating any new fields here.

{% hint style="info" %}
**Note**

The first of each type of User Defined item fields are available in the dataset in the Bevica output reports (e.g. sales order confirmation, sales invoice, sales credit memo, purchase order)
{% endhint %}

{% hint style="warning" %}
**Prerequisites**

Item setup.
{% endhint %}

### Bevica Setup

1. Navigate to **Bevica Setup** and the **User Defined Item Fields** fasttab. Here, enter the name for each of the fields you want to use. This text will appear as the caption for each field on the Item Card and List.
2. Entering a caption will initialise that field on the Item Card and List.
3. To define the values behind each Class lookup field select, on the ribbon, **Related, Item Marketing, Classes** and populate the required values.

### Item Card and List

Each field can be added to an item on the **Marketing** fasttab of the item card.

{% hint style="warning" %}
The captions entered in Bevica Setup are only available on pages. If you are looking for the field on page inspection, in a Configuration Package or SmartList it will display the Bevica Setup references, i.e **Class 2, Date 3**.
{% endhint %}


---

# 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 dynamically by asking a question.

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

```
GET https://kb.bevica.com/documentation/guides/items-and-inventory/user_defined_item_fields.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
