Customize Form
Customize Form lets you add fields that Hicom Books does not have out of the box. Kopi Rempah, for example, adds a Roast Level list to its items and a Delivery Date to its sales invoices.
Only a user with the System Manager role can add or change custom fields. Once added, every user sees them and can fill them in on documents they are allowed to edit. See Roles and Permissions.
Computer only
The Customize Form page does not open on a phone. Custom fields do show on forms on a phone.
Turn on form customization
Form customization is off on a new site.
- In the sidebar, click Setup > Settings.
- On the General tab, in Features, turn on Enable Form Customization.
- Click Save, then Yes to reload.
Customize Form now appears in the Setup group of the sidebar. If you turn the switch off later, your custom fields stay on the forms, but they can no longer be changed until you turn it back on.
Add fields to a form
- Click Setup > Customize Form.
- Click New.
- In Form Type, choose the form to extend, such as Item or Sales Invoice.
- In Custom Fields, click Add row.
- Type the Label and choose the Fieldtype. Hicom Books fills in the Fieldname from the label.
- For more settings, such as Options or Form Tab, click the Edit row button at the end of the row.
- Add a row for each field, then click Save.
The fields appear on the form as soon as you save.

Each form type has one custom form. To add more fields later, open the existing one from the Customize Form list.
Form Type also lists table rows, for example Sales Invoice Item for the item rows of a sales invoice. Fields added there appear in the row panel that opens with the Edit row button. Settings and ledger entries cannot be customized.
Field settings
| Setting | What to enter |
|---|---|
| Label | The name users see, such as Delivery Date |
| Fieldname | The internal name. It is made once from the label, such as deliveryDate, and must be unique in the form. |
| Fieldtype | Data, Text, Int, Float, Currency, Check, Date, Date Time, Select, Autocomplete, Color, Link, Dynamic Link, Attach Image, Attachment or Table |
| Is Required | The form cannot be saved while the field is empty. Give a required field a Default too. |
| Default | The value new documents start with |
| Options | For Select and Autocomplete: one option per line, at least two. For Color: your own colours, such as #8b5a2b. |
| Target | For Link: the kind of record the field points to, such as Party. For Table: the kind of row the table holds. |
| References | For Dynamic Link: a Select field on the same form whose value says which kind of record to link to |
| Form Tab | Custom (default) puts the field on a Custom tab. Type Main to place it on the form's first tab, or any other name to create a tab with that name. |
| Form Section | Default (default) is the first section of the tab. Enter a section title to use that section, or a new title to add a section at the end. |
Custom fields appear after the standard fields of their tab and section, in the order of the rows.
Example: roast level on items
| Label | Fieldtype | Options | Form Tab |
|---|---|---|---|
| Roast Level | Select | Light, Medium and Dark, one per line | Main |
| Origin | Data | Main |
Where custom fields show up
- Forms: on the tab and in the section you chose.
- Table rows: in the row panel. Click the Edit row button at the end of the row.
- Export and import: list exports and the Import Wizard include custom fields.
- Print templates: the ready-made templates do not show custom fields. In your own template, open Key hints in the Template Builder to find the name to use.
Change or remove fields
- Click Setup > Customize Form.
- Open the form type.
- Change the rows. To remove a field, delete its row.
- Click Save.
To remove every custom field of a form type, open its custom form and click ... > Delete.
Values are lost
When you remove a custom field or change its Fieldname, the values stored in that field are no longer shown on your documents.
