Payroll Setup > Employee Setup > Custom Employee Fields

Custom employee fields can be used to capture information for employees that is not already included in the Basic Info screen.

Creating Custom Employee Fields

To create custom employee fields, go to Settings > Advanced > Custom Employee Fields and click on Add.

The following fields must then be completed:

  • Sequence: This refers to the order that your custom field will appear in (i.e. if you select 7, then assuming that you have 7 custom fields, it will be shown last, assuming that the other fields are sequenced 1-6). This number will be automatically populated based on prior custom fields, but can be changed.
  • Name: Provide a name for the field.
  • Hint: If you wish to provide a further explanation or description to the name, enter it in this field.
  • Input type: Select from the following input types:
    • “Text”: For alphanumeric information
    • “Dropdown”: For selecting a particular answer from several options
    • “Date”: For selecting a date using the calendar
    • “Checkbox”: For yes/no information
    • “Number”: For numeric information
    • “Dropdown with value”: See separate section below for more information
  • If you select “Dropdown” or “Dropdown with value” from the Input Type, further fields will appear for adding options that should appear in the dropdown.
  • Required: Select this checkbox if the field is mandatory to complete and an employee cannot be saved to the system without completing this field.
  • Show on payslips: Select this checkbox if you want the custom employee field to show on all payslips for all employees.

Click Save.

Completing Custom Employee Fields

Once you have created custom employee fields, you can complete these individually or in bulk.

To complete it individually:

  • Go to an employees profile
  • Click on Edit Info > Basic Info
  • Scroll to the Custom Employee Fields heading at the bottom of the page
  • Complete the fields
  • Click Save

To complete it in bulk:

  • Go to Employees > Bulk Actions
  • Click on Essentials for custom employee fields that are set up as required fields or click on Custom Employee Fields for fields that are not set up as required fields
  • Use the filters to select specific pay frequencies, pay points or employees
  • Complete the custom employee fields created
  • Click Save

Deleting Custom Employee Fields

To delete a custom employee field, go to Settings > Advanced > Custom Employee Fields.

A list of existing custom employee fields will be shown. Select the custom employee field that you wish to delete.

Scroll to the bottom of the page and click Delete.

Dropdown with Value

This input option is only needed in specific circumstances and is unlikely to be needed if you are new to payroll. The dropdown with value option allows you to specify the label that gets used for the dropdown on the user interface (as with the normal dropdown option), and also specify the value that is assigned to represent the label on the back-end of the system.

The label will be displayed on the system, on payslips and reports. If you wish to download a list of employees with the value assigned to each of them (and not the label), you can do so by going to Employees > Bulk Actions > Custom Fields and then generating the Excel export file. This option is therefore useful if you need to report certain codes for employees to a regulatory body, but it’s easier to work with the label rather than the code.

In addition, if you are using SimplePay’s API and want to keep the back-end representation for the dropdown option on SimplePay in sync with the representation used by your system, this can be done using this option.

Removing an option in use

If you wish to remove an option, you’ll receive an error message if the option is in use. To remove an option in use, you’ll first need to use bulk inputs to change the value for existing employees to something else before trying to remove the option.

Changing a value in use

If you wish to change a value for a particular dropdown option, you’ll need to:

  • Add a new dropdown option with the new value that you wish to use. This can be done by going to Settings > Advanced > Custom Employee Fields.
  • Use bulk inputs (Employees > Bulk Actions > Custom Fields) to update the employees to the new option
  • Return to Settings > Advanced > Custom Employee Fields to remove the old option and, if necessary, rename the new option
You are using the help system of SimplePay, a payroll system that simplifies the payroll process. Designed just for South Africa, it's a fully online solution. Read more.