Skip to main content

Setting Up Custom Fields

Sinyee avatar
Written by Sinyee
Updated over a week ago

Custom fields allow you to add extra details to your transactions and contact records, giving you flexibility to capture key information and tailor documents to suit your industry requirements. You can also choose whether these fields appear internally or on PDF transactions, ensuring that the right information is visible where it matters most.


Setting Up a Custom Field

Follow these steps to set up a custom field:

  1. Navigate to Control Panel > Custom Fields and click +New.

  2. Define the Custom Field:

    1. Enter a Name for the field.

    2. Select a Type:

      1. Contact – Links the field to your contacts. The data in transactions is controlled by the contact’s profile.

      2. Transaction – Links the field to transactions, allowing you to update the data for each transaction.

    3. Choose the Data Type:

      1. Text - Allows free text input.

      2. Amount - Displays values in amount format.

      3. Date - Uses a date format with a calendar for selection.

      4. Dropdown - Requires predefined options for selection.

        • Example Dropdown (e.g.: Person In Charge)

    4. Tick Set as Required if the field must always be filled in.


  3. Choose where the field appears:

    1. In the Show In section, enable the toggle for the transactions where you want the field to be displayed:

      1. For a Contact-type field, enabling this option will display the field on the PDF transaction.

      2. For a Transaction-type field, enabling this option allows users to enter data for the field in each transaction. To include it in the PDF transaction, tick Show in PDF.

    2. This means the custom field can be used for internal purposes only, or set to appear on the PDF transaction. You might want to add a field to your transactions but not necessarily want it to appear on PDF transaction.

  4. Once done, click Save.

Examples of Custom Fields

Here’s how custom fields work for both Contact-type and Transaction-type fields.

Example 1: Contact-Type Field

  • Name: Member ID

  • Type: Contact

  • Data Type: Text

  • Show in: Invoice

To view this field:

  • Go to the Contact module, click View on an existing contact or create a +New contact.

  • You will see the Member ID field in the Custom Fields section.

  • The Member ID will appear in the contact details section of the PDF invoice as follows:


Example 2: Transaction-Type Field

A list of transaction-type fields with different data types have been created and set to show on the PDF invoice.

To view these fields:

  • When creating a transaction under Sales > Invoice, you will see the fields in the Custom Fields section.

  • The field will appear in the PDF invoice as shown below:

Notes

  1. When to Use Custom Fields - Custom fields are useful when you need to capture additional details that are not available in the default fields or when you want certain information to appear on PDF transactions.

  2. Alphabetical Arrangement of Fields - Custom fields will be arranged in alphabetical order for better organization.

  3. Automatic Custom Field Alignment - When a transaction contains more than four custom fields, system will automatically structure them in a dedicated table section.

  4. Custom Field Column in Transaction Listing - You can add the custom field column in transaction listing from the column chooser, allowing for better visibility and improved tracking of your transactions.

  5. Search Custom Fields - You can search for a keyword within a custom field that has been added to your transactions.

Did this answer your question?