Custom fields

Custom fields

Use custom fields to add your own field to employee profiles when KAMI has no standard one: a professional licence number, a locker number, a job grade, a client code. Once you create it, the field appears on the profile, and you can fill it in by hand or import it.

Where: More (bottom left) › Settings › Company › Custom Fields

You need: the Custom Fields right. Read opens the page, write lets you add and change fields.

Which one, when

You want to recordUse
Structured data about a person that KAMI does not holdA custom field
A document about a personAn upload on their profile, or Document Templates
Something about the job rather than the personThe position or department

A custom field is worth creating when you will filter, report or import on it. Every field is one more thing to keep up to date.

How to add a custom field

  1. Select More at the bottom left, then Settings.
  2. Under Company, select Custom Fields, then Add Field.
  3. Enter the Name. This is the label people see.
  4. Enter the Variable, with no spaces, such as prc_licence_number. It cannot be changed after you create the field.
  5. Choose the Type: Whole Number, Decimal, Date, DateTime, Text, List or Boolean.
  6. Choose the Level. For a field on employee profiles, choose Profile.
  7. Choose the Section, which is where the field appears on the profile, such as Private Info, Job details or ID & Registrations.
  8. For a List, enter the options in Source, separated by commas.
  9. Tick any of the options described below.
  10. Select Create.

The custom field form: name, variable, type, order, level, section, limits, options and tick boxes

To change a field, select its pencil icon, make the change and select Update. To remove one, select its bin icon, then Yes. Drag a row to change the order. Fields KAMI creates for your country cannot be changed or deleted.

What each option does

OptionWhat it does
OrderWhere the field sits among the others
Min Value / Max ValueThe lowest and highest number allowed. For text, the shortest and longest length
UniqueNo two employees can have the same value
RequiredThe field must have a value before the record can be saved
Enable DemographicsAdds the field to the Demographics report. List type only, at Profile or Education level
Display On Org ChartShows the value on the org chart. Profile level only
Use For Payroll Report GroupingLets you group payroll reports by it. Profile level only
Record In LifecycleKeeps a history of changes to the field on the employee's Lifecycle
⚠️ Required applies to people already in KAMI. Once it is on, saving a profile with no value fails, so fill the field in first.

How to fill in a field for many employees

  1. Use Bulk data import and export to load values for everyone at once.
  2. To edit a few, open the employee's profile, go to the section you chose and enter the value.

What Happens Next

  • The field appears on employee profiles in the section you chose.
  • It is available in bulk import and export.
  • Fields in ID & Registrations appear in the Government IDs step of the Onboarding Wizard.
  • The tick boxes above add it to the reports and pages they name.

Tips

  • Choose the section with care. Whoever can open that section of a profile can see the field, so do not put sensitive data in a section everyone can read.
  • Name it for exactly what it holds. "PRC licence number" is better than "Licence number". You can rename it later, but the Variable stays.
  • Use a List when you plan to report on it. Free text gives you ten spellings of one answer, and only a List can go in Demographics.
  • Do not create a field you have no plan to fill in. An empty field on every profile helps nobody.
  • Review them once a year. Fields from a finished project are clutter.

Troubleshooting / FAQ

Q: How do I add a new field to employee profiles? Follow the steps above with Level set to Profile.

Q: Why does it say my field name has spaces? The Variable cannot contain spaces. Use underscores.

Q: Why can't I change the Variable? It is locked once the field exists. Create a new field if it is wrong.

Q: Saving an employee now fails with a required field error. A Required custom field has no value on that profile. Fill it in, or untick Required.

Q: My field is not in the Demographics report. Tick Enable Demographics. The field must be a List at Profile or Education level.

Q: Someone cannot see a field I created. It follows their access to that section of the profile. See User rights and access control.

Related articles