> ## Documentation Index
> Fetch the complete documentation index at: https://superofficeas-bugfix-ty-screen-designer-paradox.mintlify.site/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>

<Danger>
  **Making a field mandatory? Make sure it has somewhere to live.**

  If the **More** tab has been removed in Screen Designer, a newly-mandatory field
  may have no place to appear on the screen. When that happens, users can't save
  new records — and the disabled **Save** button won't clearly explain why.

  Before marking a field as mandatory, open Screen Designer for the affected
  entity and confirm the field is visible on a tab that users can actually reach.
</Danger>

<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
