# Custom fields on order

Since v2.2.1 you can add custom-defined fields to the order form.

## Setting up the custom fields

The custom fields can be entered if you login as admin and then go to Site Setting. There go to the "Setup" tab and on the bottom, you will see the "Custom fields" section.

The custom fields are defined using JSON syntax. So make sure [you have a valid](https://jsonlint.com/) JSON string.

Here is an example of custom fields. You can use this [tool](https://jsoneditoronline.org/) to create the JSON.

```
[{
        "title": "Customer phone numner",
        "key": "customer_phone_number",
        "ftype": "input",
        "type": "phone",
        "placeholder": "Enter your phone"
    },
    {
        "title": "Customer email",
        "key": "customer_email",
        "ftype": "input",
        "type": "email",
        "value": "predefined@email.com"
    },
    {
        "title": "Country",
        "key": "customer_country",
        "ftype": "select",
        "data": {
            "macedonia": "Macedonia",
            "usa": "United States of America"
        }
    },
    {
        "title": "is this a gift",
        "key": "send_as_gift",
        "ftype": "bool",
        "value": true
    },
    {
        "title": "Custom note",
        "key": "custom_note",
        "ftype": "textarea"
    }
]
```

In the example above, this will output 5 form fields in the order tab.

![Custom Fields](https://i.imgur.com/WWMyFgq.png)

Here is an explanation of the different fields use

| Field key   | Description                                                                                                   |
| ----------- | ------------------------------------------------------------------------------------------------------------- |
| title\*     | Title - label on the fields                                                                                   |
| key\*       | The unique identifier - use lowercase no space and no special characters                                      |
| ftype       | input, select, bool, textarea                                                                                 |
| type        | When ftype is an input you can define [input types](https://www.w3schools.com/html/html_form_input_types.asp) |
| placeholder | Placeholder for input                                                                                         |
| value       | Predefined value                                                                                              |
| data        | Used only in ftype=select. List of option for the select                                                      |

## Translation of the custom fields

You should add translation keys for these custom fields keys inside the translation menu. Add them to the "**custom**" group as shown on the image.

![Add new language](https://i.imgur.com/hKNpl8J.png)


---

# Agent Instructions: 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:

```
GET https://mobidonia.gitbook.io/mresto/usage/custom-fields-on-order.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.