Appearance
Custom fields
Platform settingsOrganisationCustom fieldsPermission:
settings.company.vieworsettings.company.manageOpen in Roari ERP (new tab)Also known as
- user-defined fields
- UDF
- extra fields
- additional fields
- custom attributes
- flex fields
- form fields
- dropdown
- picklist
- field configuration
Custom fields add your own fields to records such as items, customers, sales orders or employees. They appear in the record's form and detail page, in lists, in CSV imports and exports, and in the API. Account administrators define them here, per record type.
Add a custom field
- Go to SettingsCustom fields.
- Pick the Record type, for example Item.
- Select New field. The New custom field drawer opens.
- Type the Label. The Key fills in from the label; change it if you want a different one.
- Pick the Type. For Choice (one) or Choice (several), type each choice in Choices and press Enter after each one.
- Tick Required if people must fill it in before saving the record.
- Select Add field. The new field goes to the end of the list.
Fields of the drawer
| Field | Required | What to enter |
|---|---|---|
| Label | Yes | What users see on the form, for example Shelf life (days). Message if empty: Enter a label. |
| Key | Yes | Used in imports, exports and the API. Lower case letters, digits and underscores, starting with a letter. A key used twice on the same record type gives Already in use for this entity. Cannot change after the field is created. |
| Type | Yes | See the types below. Cannot change after the field is created. |
| Choices | For choice types | At least two choices: Add at least two choices. |
| Required | No | People must fill it in before saving the record. |
| Type | Holds |
|---|---|
| Text | Free text |
| Number | A number |
| Money | An amount |
| Date | A date |
| Choice (one) | One value from your list |
| Choice (several) | Any number of values from your list |
| Yes / no | A tick box |
| User | A user of your organisation |
| Web address | A link |
Record types: Item, Customer, Sales order, Vendor, Purchase order, Employee, Project and Service case.
Edit, reorder or delete a field
- Edit: select the row or its pencil icon, change the label, choices or Required, then select Save field.
- Reorder: use the up and down arrows. The order here is the order on the form.
- Delete: select the bin icon, then Delete field. The field leaves every form, the values already stored in it are hidden, and imports ignore its column.
Differences by role
- Account admin manages custom fields. Users who can only view see the table withoutthe buttons.
Related
- Custom fields: how custom fields show on records, lists and imports
- Import and export
- Items
- Workflow rules: set a custom field automatically
