Add fields without coding — customize fields to fit your business.

This guide shows you how to add new input fields to the ERPNext screen without coding. You'll learn how to use various field types such as text, date, select, and link.

7 min
Updated: September 3, 2025

Custom fields

1. Introduction

While ERPNext can cover a wide range of business processes with its standard features alone, there will inevitably be needs to "add a few more fields" or "make the input screen easier to use" to meet the specific requirements of the workplace.

To meet these needs, ERPNext comes standard with five customization options.

    Among these options, the easiest to use and the most adaptable to your work with just mouse operations is "Custom Fields".
    Furthermore, custom fields do not add columns directly to the core database, but rather are dedicatedtabCustom Field It is managed using tables. Therefore, a key feature is that customizations are less likely to break even when the ERPNext core is updated.
    (Details of the mechanism will be explained in a separate article) Unbreakable customization Please see below.

    In this article,

    • A variety of data types to choose from in "Custom Fields"
      Actual additional steps

      Let me introduce you to you.

    2. Representative Examples and Explanations of Data Types

    The data types you can choose from in ERPNext's custom fields are extremely diverse. They can be broadly categorized into the following groups:

    • ✍️Text-based ... Input of characters and sentences
    • 🔢 Numerical and Calculation-Related ... Numbers, amounts, percentages, etc.
    • 📅Date and Time Related ... Delivery date and time
    • 📂Selection/Reference Systems ... Drop-down selection and linking to existing data
    • 🖼️Files and Media ... Images and attachments
    • ☑️Input assistance/control systems ... Checkboxes, buttons, etc.
    • 📐Layout and Display ... Adjust the configuration of the input screen.

    ✍️ Text-based

    TypeDescriptionUsage Examples
    DataSingle-line textModel number / Phone number
    Small Text / Long TextShort/Long TextNotes, Notes
    Text Editor / Markdown / HTML EditorRich TextProcedures, Manuals

    🔢 Numerical and Calculation Systems

    TypeDescriptionUsage Examples
    Int / FloatInteger / Decimal NumberQuantity, Dimensions
    CurrencyCurrencyAmount, Unit Price
    Percent / Rating / DurationPercentage, Rating, DurationProgress Rate, Review, Process Time

    📅 Date and Time System

    TypeDescriptionUsage Examples
    Date / Datetime / TimeDate and TimeDelivery Date, Inspection Time

    📂 Selection and Reference Systems

    TypeDescriptionUsage Examples
    SelectDropdown optionsStatus, Priority
    MultiSelectMultiple ChoicesLabels, Attribute Tags
    LinkLink registered dataCustomers, products, projects
    Table / Table MultiSelectChild TableDetail Rows, Association List

    🖼️ File and Media

    TypeDescriptionUsage Examples
    Attach / Attach ImageFile/Image AttachmentDesign Drawings, Inspection Photos
    ImageThumbnail displayProduct image
    SignatureEnter SignatureConfirm Receipt

    ☑️ Input assistance and control systems

    TypeDescriptionUsage Examples
    CheckCheckboxCompletion flag, safety check
    ButtonButtonCall Automatic Processing
    ColorColor SelectionStatus Color Coding
    Barcode / QR CodeBarcode displayLabel printing
    GeolocationLocation informationSite location
    Read OnlyFor reference onlyAutomatic calculation result
    Password / Email / URL / PhoneVerified InputAccounts, Contacts

    📐 Layout and Display Systems

    TypeDescriptionUsage Examples
    Section / Column / Tab Break / HeadingLayout ControlOrganizing Input Screens
    HTML / IconStatic displayWarning, decoration

    *Names may vary depending on the version and environment.


    3. Strengths of ERPNext

    What's particularly convenient is that the following four data types can be easily added using only the GUI.

    Data TypeDescriptionUsage Examples
    SelectDefine dropdown optionsStatus, Priority, Process Category
    LinkLink registered dataCustomers, products, projects
    TableChild tables will hold detailsDetail rows, subtasks, process steps
    Attach / Attach ImageAttach files/imagesDesign drawings, inspection photos, drawings

    These can be added without any programming using the "Custom Forms" feature in ERPNext.
    Furthermore, custom fields are stored in a dedicated tab called tabCustom Field and do not directly modify the core tables.
    This allows you to achieve "unbreakable customization" without having to worry about updating the main unit's software.

    In many conventional business systems, adding such items required modifying the database or changing the core code, which inevitably increased development effort and merge work.

    ERPNext eliminates this burden, which is a great help to the IT department.
    For example, even for something as simple as adding an input field, it was not uncommon in the past to require outsourcing costs of hundreds of thousands of yen and development time of several weeks.
    With ERPNext, internal staff can configure it in just a few minutes, which significantly reduces development and operational costs.


    4. Setting Custom Field Properties

    After adding a custom field, you can fine-tune the input rules and behavior. In ERPNext, you can set the following properties from the GUI:

    • ❕Required Field → Cannot save if left blank
    • 🔓Read Only → Items that cannot be edited, such as automatically calculated results.
    • 🔄Default Value → Set a value in advance to save time.
    • 💎 Unique → Duplicates are prohibited, such as employee numbers and serial numbers.
    • ⚠️Conditionally Required (Depends On) → Required depending on the value of other fields
    • 👀Hide → Keep the input screen simple

    By combining these settings, you can prevent input errors while achieving smooth operation tailored to your business needs.


    5. Steps to add a custom field (Example: Adding a coin element to Work Order)

    Let's actually add the "Coins Earned" and "Level" fields to the Work Order.

    1. Open the target DocType
    • Search for "work instructions" in the search bar and open it.
    • Click "Edit Document Type" from the "Menu" in the upper right corner.  Customizable Forms
    1. A customizable form will be displayed.
    • Existing fields are listed, and there is an "Add New Field" button at the bottom.  Customizable Forms
    1. Field 1: Number of Coins Acquired
    • Display name: Coin acquisition count
    • Field name: coin_count
    • Data type: Int
    • Initial value: 0
    • Read-only: Yes  Customizable Forms
    1. Determine the placement location.
    • Drag the item and place it under Status, etc.  Customizable Forms
    1. Save and "Update"
    • Press the "Save" button in the upper right corner, then click "Update".
    • The new fields will be reflected in the actual Work Order form.

    Customizable Forms


    6. Summary

    ERP Next custom fields are

    Easily expandable

    Designed to withstand updates

    That's its biggest appeal.

    In this example, by adding "coin acquisition count" to the Work Order, we were able to add a playful element to the workplace while also visualizing the data.

    Furthermore, by combining a wide range of data types and property settings, you can flexibly create input rules tailored to your specific business needs.

    We encourage you to utilize ERPNext's custom fields to create a system tailored to your specific needs.

    📚

    Related articles