brotherton-erpnext/erpnext/docs/user/manual/en/customize-erpnext/customize-form.md

4.4 KiB

Before we venture to learn form customization tool, click here to understand the architecture of forms in ERPNext. It shall help you in using Customize Form tool more efficiently.

Customize Form is the tool which allows user to customize the property of standard fields as per the requirement. Let's assume we need to set Project Name field as mandatory in the Sales Order form. Following are the steps which shall be followed to achieve this.

####Step 1: Go to Customize Form

You can go to Customize Form from:

Setup >> Customize >> Customize Form

System Manager will find Customize Form option in the Sales Order list (or any other form for that matter) view as well.

Customize Form List View

####Step 2: Select Docytpe/Document

You should select Docytpe/Document which has field-to-be-customized located in it.

Customize Form Document

####Step 3:Edit Property

On selecting Doctype/table, you will have all the fields of the table updated as rows in the Customize Form table. You should drill down to field you need to work on, Project Name in this case.

On clicking Project Name row, fields to set various property for this field will be shown. To Customize the mandatory property for a field, there is a field called "Mandatory". Checking this field will set Project Name field as mandatory in the Quotation form.

Customize Form Mandatory

Like this, you can customize following properties of the field.

  • Change field types (for e.g. you want to increase the number of decimal places, you can convert come fields from Float to Currency).
  • Change labels to suit your industry / language.
  • Make certain fields mandatory.
  • Hide certain fields.
  • Change layout (sequence of fields). To do this, select a field in the grid and click on“Up” or “Down” in the grid toolbar.
  • Add / edit “Select” Options. (for example, you can add more sources in Leads etc).

####Step 4: Update

Customize Form Update

Before checking Sales Order form, you should clear cache and refresh browser tab for customization to take effect.

For Customize Form, you can also allow attachments, set max number of attachments and set the default Print Format.

Note: Though we want you to do everything you can to customize your ERP based on your business needs, we recommend that you do not make “wild” changes to the forms. This is because, these changes may affect certain operations and may mess up your forms. Make small changes and see its effect before doing some more.

Following are the properties which you can customize for a specific field from Customize Form.

Field property Purpose
Print hide Checking it will hide field from Standard print format.
Hidden Checking it field will hide field in the data entry form.
Mandatory Checking it will set field as mandatory.
Field Type Click here to learn about of fields types.
Options Possible result for a drop down fields can be listed here. Also for a link field, relevant Doctype can be provided.
Allow on submit Checking it will let user update value in field even in submitted form.
Default Value defined in default will be pulled on new record creation.
Description Gives field description for users understanding.
Label Label is the field name which appears in form.

{next}