Add a custom field

To create an additional field that can store non-standard information, perform the following steps:

  1. Go to the Configuration menu → General Configuration → Custom Fields and Columns → Custom Fields tab.

    Custom  fields.png
  2. Click the Add Custom Field button on top of the table. You will be directed to the Add Custom Field page.

    Custom fields1.png
  3. Provide the field’s Name. It will be displayed as a custom field's label on the Home Portal.

    1. Click the Add Localized Name to provide a different name for the Client Portal.

  4. Provide a short Description of the new field. You will see this description when hovering over the custom field’s name.

  5. Select the Type of the field. The available options are:

    • Checkbox

    • Date

    • Date and Time

    • Multiple Selection

    • Number

    • Selection

    • Text

If you select the Multiple Selection or Selection type, an Item section will appear below. Click on the Add… icon and provide the desired value. You can add as many items as you need.

  1. Decide on the Default Value of the field. The available options in this section will depend on the selected field type.

  2. From the Scope section, select the Home Portal areas, where the new field will appear.

    1. (For quotes or projects) In the Services section, select to which services the field should be applied.

    2. (For quotes) Decide whether the field should be Available for Quote Request Form.

  3. Decide whether the new field should be Available for Client Portal.

  4. From the Visibility drop-down list, select where the field should be visible, accessible, and editable:

    • Visible and editable on UI and accessible from API

    • Visible on UI, accessible from API

    • Hidden on UI, accessible from API.

  5. Click the Add button.

  6. (Optional) You can group custom fields or change their order in the Configuration menu → General Configuration → Custom Fields and Columns → Field Layout tab.

    1. From the Scope drop-down list, select the area of the Home Portal.

    2. Drag and drop the fields to rearrange their order.

    3. In Client and Vendor areas, you can add new field groups within the Identification Data and Sales Data tabs.
      To add a new group:

      1. Click on the Identification Data or Sales Data lines.

      2. Click the Add Group button. A new text field appears.

      3. Provide the name for the new group.

      4. Click the icon to add the group.

      5. Drag and drop the fields to add them to the group.

      6. To delete or rename a group, click on its line and then click the Delete Group or Rename Group button.

Custom fields will appear in the following areas of the Home Portal:

  • Contact Person: The field shows up in both modules:

    • Clients Module > Contact Person > Main Data tab,

    • Vendors Module > Contact Person > Main Data tab,

  • Client: Clients Module > Main Data tab > Identification Data subtab or Main Data tab > Sales Data subtab,

  • Vendor: Vendors Module> Main Data tab > Identification Data subtab,

  • User: Configuration menu > User Management > Users > User > General Info tab,

  • Project: (Smart) Project > Side panel (Classic) Project > Main Data tab

  • Quote: Quotes Module > Main Data tab,

  • Job: The field shows up in both modules (IMPORTANT! This custom field is available for Classic Projects only!):

    • Projects Module > Job > Main Data tab,

    • Quotes Module > Job > Main Data tab,

  • Task: The field shows up in both modules:

    • Projects Module > Task > Main Data tab,

    • Quotes Module > Task > Main Data tab.

Custom fields limitations

Custom fields limitations

Text

20480 characters
Please bear in mind that:

  • CFs do not allow text formatting

  • if the text is over 57 characters, you'll need to scroll manually to see it

  • long texts may affect the system performance.

Selection (option text length)

about 50 characters

Multiple Selection (option text length)

about 30 characters

Number

about 30 digits