Customize Form
How to use Customize Form in Customization: access, working steps, fields, related records and troubleshooting.
Purpose and access
Use Customize Form and Custom Field for supported record extensions. Choose an appropriate field type, label, identifier and placement. Test required, unique and link behavior in staging, and check impact on reports, imports and APIs.
This page is a settings page in System Admin → Customization. Use the link above to open the configured destination; permissions are checked by the destination service.
Before you start
Prepare the required information: Fields.
Confirm the company, party, dates, units and source references that apply. Select existing links carefully and check for an existing record before creating a duplicate.
Working steps
- Open Customize Form from System Admin → Customization, or use ERP Search.
- Review the existing configuration before editing.
- Complete the editable fields described below. Required fields and validation conditions must be satisfied; read-only values are set by the system or their source records.
- Add the required child rows. Review each row’s identifiers, linked records and values, using the child-table field reference below.
- Save the record and address validation messages. Reload and verify the saved values and relationships.
- Use any additional workflow actions only when the record and your role provide them. Saving this record does not automatically complete a related transaction or external action.
Field reference
These fields come from the installed ERP definition. Hidden fields and password inputs are omitted. Additional conditions, custom scripts and workflow rules can make a field required or read-only in a particular context.
| Field | Type / behavior | How to use it |
|---|---|---|
Enter Form Typedoc_type | Link Optional | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: DocType |
Change Label (via Custom Translation)label | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Search Fieldssearch_fields | Data Optional | Fields separated by comma (,) will be included in the "Search By" list of Search dialog box |
Grid Page Lengthgrid_page_length | Int Optional | Enter a whole-number value. |
Rows Threshold for Grid Searchrows_threshold_for_grid_search | Int Optional | Enter a whole-number value. |
Is Tableistable | Check Optional · Read-only | Enable or disable the named option only when it matches the intended record behavior. |
Is Calendar and Ganttis_calendar_and_gantt | Check Optional | Enables Calendar and Gantt views. |
Editable Grideditable_grid | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Quick Entryquick_entry | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Track Changestrack_changes | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Track Viewstrack_views | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Allow Auto Repeatallow_auto_repeat | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Allow Import (via Data Import Tool)allow_import | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Allow Bulk Editallow_bulk_edit | Check Optional | Enable bulk edit for child table fields in Form view. |
Queue in Background (BETA)queue_in_background | Check Optional | Enabling this will submit documents in background |
Naming Rulenaming_rule | Select Optional | Choose one of the configured list values. Status fields may be controlled by the record workflow.Available choices
|
Auto Nameautoname | Data Optional | Naming Options: field:[fieldname] - By Field naming_series: - By Naming Series (field called naming_series must be present) Prompt - Prompt user for a name [series] - Series by prefix (separated by a dot); for example PRE.##### format:EXAMPLE-{MM}morewords{fieldname1}-{fieldname2}-{#####} - Replace all braced words (fieldnames, date words (DD, MM, YY), series) with their value. Outside braces, any characters can be used. |
Image Fieldimage_field | Data Optional | Must be of type "Attach Image" |
Max Attachmentsmax_attachments | Int Optional | Enter a whole-number value. |
Hide Sidebar, Menu, and Commentshide_toolbar | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Hide Copyallow_copy | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Make Attachments Public by Defaultmake_attachments_public | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Protect Attached Filesprotect_attached_files | Check Optional | Users are only able to delete attached files if the document is either in draft or if the document is canceled and they are also able to delete the document. |
Title Fieldtitle_field | Data Optional | Use this fieldname to generate title |
Show Title in Link Fieldsshow_title_field_in_link | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Translate Link Fieldstranslated_doctype | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Default Print Formatdefault_print_format | Link Optional | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: Print Format |
Default Viewdefault_view | Select Optional | Choose one of the configured list values. Status fields may be controlled by the record workflow. |
Force Re-route to Default Viewforce_re_route_to_default_view | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Show Preview Popupshow_preview_popup | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Make "name" searchable in Global Searchshow_name_in_global_search | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Default Email Templatedefault_email_template | Link Optional | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: Email Template |
Allow document creation via Emailemail_append_to | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Sender Email Fieldsender_field | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Sender Name Fieldsender_name_field | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Recipient Account Fieldrecipient_account_field | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Subject Fieldsubject_field | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Sort Fieldsort_field | Select Optional | Choose one of the configured list values. Status fields may be controlled by the record workflow. |
Sort Ordersort_order | Select Optional | Choose one of the configured list values. Status fields may be controlled by the record workflow.Available choices
|
Actionsactions | Table Optional | Add the relevant child rows and review required columns, quantities and references before saving. Linked record: DocType Action |
Linkslinks | Table Optional | Add the relevant child rows and review required columns, quantities and references before saving. Linked record: DocType Link |
Statesstates | Table Optional | Add the relevant child rows and review required columns, quantities and references before saving. Linked record: DocType State |
Fieldsfields | Table Required | Add the relevant child rows and review required columns, quantities and references before saving. Linked record: Customize Form Field |
Child tables
Actions — child-row fields
| Field | Type / behavior | How to use it |
|---|---|---|
Labellabel | Data Required | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Action Typeaction_type | Select Required | Choose one of the configured list values. Status fields may be controlled by the record workflow.Available choices
|
Action / Routeaction | Small Text Required | Provide concise contextual information relevant to the record. Avoid unrelated personal or confidential data. |
Groupgroup | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Hiddenhidden | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Links — child-row fields
| Field | Type / behavior | How to use it |
|---|---|---|
Link DocTypelink_doctype | Link Required | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: DocType |
Link Fieldnamelink_fieldname | Data Required | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Parent DocTypeparent_doctype | Link Optional | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: DocType |
Table Fieldnametable_fieldname | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Groupgroup | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Hiddenhidden | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Is Child Tableis_child_table | Check Optional · Read-only | Enable or disable the named option only when it matches the intended record behavior. |
States — child-row fields
| Field | Type / behavior | How to use it |
|---|---|---|
Titletitle | Data Required | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Colorcolor | Select Required | Choose one of the configured list values. Status fields may be controlled by the record workflow.Available choices
|
Fields — child-row fields
| Field | Type / behavior | How to use it |
|---|---|---|
Labellabel | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Typefieldtype | Select Required | Choose one of the configured list values. Status fields may be controlled by the record workflow.Available choices
|
Namefieldname | Data Optional · Read-only | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Non Negativenon_negative | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Mandatoryreqd | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Uniqueunique | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Is Virtualis_virtual | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
In List Viewin_list_view | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
In Standard Filterin_standard_filter | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
In Global Searchin_global_search | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
In Previewin_preview | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Boldbold | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
No Copyno_copy | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Set only onceset_only_once | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Allow in Quick Entryallow_in_quick_entry | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Translatabletranslatable | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Maskmask | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Filterslink_filters | JSON Optional | Filters applied to Link queries and Attachment Gallery files. |
Defaultdefault | Small Text Optional | Provide concise contextual information relevant to the record. Avoid unrelated personal or confidential data. |
Precisionprecision | Select Optional | Set non-standard precision for a Float or Currency fieldAvailable choices
|
Lengthlength | Int Optional | Enter a whole-number value. |
Optionsoptions | Small Text Optional | Provide concise contextual information relevant to the record. Avoid unrelated personal or confidential data. |
Sort Optionssort_options | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Fetch Fromfetch_from | Small Text Optional | Provide concise contextual information relevant to the record. Avoid unrelated personal or confidential data. |
Fetch on Save if Emptyfetch_if_empty | Check Optional | If unchecked, the value will always be re-fetched on save. |
Show Dashboardshow_dashboard | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Depends Ondepends_on | Code Optional | This field will appear only if the fieldname defined here has value OR the rules are true (examples): myfield eval:doc.myfield=='My Value' eval:doc.age>18 |
Perm Levelpermlevel | Int Optional | Enter a whole-number value. |
Hiddenhidden | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Read Onlyread_only | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Collapsiblecollapsible | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Allow Bulk Editallow_bulk_edit | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Collapsible Depends Oncollapsible_depends_on | Code Optional | Administrator/integration field. Use a validated configuration or supported script and test its impact before deployment. |
Ignore User Permissionsignore_user_permissions | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Allow on Submitallow_on_submit | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Report Hidereport_hide | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Remember Last Selected Valueremember_last_selected_value | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Hide Borderhide_border | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Ignore XSS Filterignore_xss_filter | Check Optional | Don't encode HTML tags like <script> or just characters like < or >, as they could be intentionally used in this field |
Mandatory Depends Onmandatory_depends_on | Code Optional | Administrator/integration field. Use a validated configuration or supported script and test its impact before deployment. |
Read Only Depends Onread_only_depends_on | Code Optional | Administrator/integration field. Use a validated configuration or supported script and test its impact before deployment. |
Button Colorbutton_color | Select Optional | Choose one of the configured list values. Status fields may be controlled by the record workflow.Available choices
|
In Filterin_filter | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Hide Secondshide_seconds | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Hide Dayshide_days | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Descriptiondescription | Text Optional | Provide the required record description or content. Keep operational instructions clear and applicable. |
Placeholderplaceholder | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Print Hideprint_hide | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Print Hide If No Valueprint_hide_if_no_value | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Print Widthprint_width | Data Optional | Print Width of the field, if the field is a column in a table |
Alignmentalignment | Select Optional | Choose one of the configured list values. Status fields may be controlled by the record workflow.Available choices
|
Columnscolumns | Int Optional | Number of columns for a field in a Grid (Total Columns in a grid should be less than 11) |
Widthwidth | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Troubleshooting
- Not permitted: verify the account, role and source-document permission. Do not share an administrator login.
- Missing record or address: inspect the relevant Link or Dynamic Link fields; a matching title alone does not establish a relationship.
- Cannot save or change status: review required fields, read-only values, document status and the configured approval transition.
- Unexpected report or portal result: review company/date filters, source-document submission and the approved party or Employee link.