> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add user-defined field

> How to add a user-defined field in Settings and maintenance

<Frame caption="Watch this video to find out how you can create your own extra fields in SuperOffice CRM (video length - 2:51)">
  <iframe width="100%" height="420" src="https://www.youtube-nocookie.com/embed/SpeZVxpxeMM" title="Watch this video to find out how you can create your own extra fields in SuperOffice CRM (video length - 2:51)" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

## Steps

1. Go to **Settings and maintenance** > **Fields**. Then select the required tab: **Company**, **Contact**, **Project**, **Sale**, **Follow-up**, or **Document**.

2. Click the **Add** button below the **Fields** list.

3. Enter a **Name** and select a [**Type**][2] (for example number, text, or date).

   Use a [language prefix](#language) to specify the name in multiple languages like this: `US:"Language";NO:"Språk"`

   ![UDEF field name in multiple languages -screenshot][img3]

4. Optionally set other [field properties](#properties), such as whether the field is mandatory or should be indexed.

5. When you are done, click **Save**. The dialog closes and the new field is displayed in the **Fields** list and in the grid.

6. [Optionally, adjust the position of the field][3]. This requires the Development Tools license or the Core plan.

7. Continue adding fields. Click **Publish** when you are done to make the field available to SuperOffice users. Unpublished fields and fields with unpublished changes are displayed in bold text in the **Fields** list.

<h2 id="properties">
  Field properties
</h2>

| Property      | Description                                                                                                                                                                                         |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Default value | The value to be inserted by default in this field.                                                                                                                                                  |
| Tooltip       | A brief description appearing when hovering over the field. For example, usage information.                                                                                                         |
| Prog ID       | A default ID for this field. The format is **text:number**. Keep the text portion to letters a-z or their uppercase equivalents. Can be overridden by SuperOffice partners.                         |
| Mandatory     | Makes it mandatory to fill in this field. Does not apply to the *Checkbox* field type.                                                                                                              |
| Hide label    | If selected, the name of the field is not displayed.                                                                                                                                                |
| Read only     | If selected, it is not possible to amend the field.                                                                                                                                                 |
| Indexed       | If selected, this field becomes searchable, speeding up **Find**. Non-indexed fields can also be searched, but it is slower. Index only fields that are often searched and hold commonly used data. |

<Note>
  You cannot check **Read only** if you checked **Mandatory**. These options are mutually exclusive.
</Note>

<h2 id="language">
  Language codes
</h2>

|  ID | Language  |
| :-: | --------- |
|  NO | Norwegian |
|  SP | Spanish   |
|  US | English   |
|  CZ | Czech     |
|  SW | Swedish   |
|  CN | Chinese   |
|  DA | Danish    |
|  JP | Japanese  |
|  GE | German    |
|  FI | Finnish   |
|  NL | Dutch     |
|  RU | Russian   |
|  FR | French    |
|  PL | Polish    |
|  IT | Italian   |

## Where will the fields I create be displayed?

User-defined fields you create will appear in the [More tab][5] for Companies, Contacts, Sales, and Projects, as well as in the Follow-up and Document dialogs.

In the lower right of the **Fields** dialog is the **Template variable name** followed by a code (ID), which can be used to reuse the information you enter in this field, for example, as [template variables][12] in documents and emails.

## Troubleshooting

### I cannot create a new field

If you find you are not allowed to create a new field, this may be because you have already reached the [maximum number of permitted fields][1] of this type. You must then delete an existing field before you can insert a new one.

Four of each type of field (Short text, Long text, Number, Decimal) are searchable. For example, if you do not mark any fields searchable, you can specify only six Decimal fields.

## Related topics

* [Place fields][3]
* [Edit field properties][4]
* [Screen designer][11]

[1]: ../learn/udef#limit

[2]: ../learn/udef#field-types

[3]: ./edit-udef-layout

[4]: ./edit-udef

[5]: ../learn/more-tab

[11]: ../../customization/screen-designer/admin/index

[12]: ../../document/templates/learn/template-variables

[img3]: /media/loc/en/custom-objects/add-udef-multi-languages.png


## Related topics

- [The More tab](/en/custom-objects/learn/more-tab.md)
- [User-defined fields](/en/custom-objects/learn/udef.md)
- [User-defined lists](/en/admin/lists/user-defined-lists.md)
- [Customize layout of user-defined fields](/en/custom-objects/admin/edit-udef-layout.md)
- [Save User Defined Field Info](/en/api/reference/restful/agent/userdefinedfieldinfo_agent/save-user-defined-field-info.md)
