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 record | Use |
|---|---|
| Structured data about a person that KAMI does not hold | A custom field |
| A document about a person | An upload on their profile, or Document Templates |
| Something about the job rather than the person | The 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
- Select More at the bottom left, then Settings.
- Under Company, select Custom Fields, then Add Field.
- Enter the Name. This is the label people see.
- Enter the Variable, with no spaces, such as
prc_licence_number. It cannot be changed after you create the field. - Choose the Type: Whole Number, Decimal, Date, DateTime, Text, List or Boolean.
- Choose the Level. For a field on employee profiles, choose Profile.
- Choose the Section, which is where the field appears on the profile, such as Private Info, Job details or ID & Registrations.
- For a List, enter the options in Source, separated by commas.
- Tick any of the options described below.
- Select Create.

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
| Option | What it does |
|---|---|
| Order | Where the field sits among the others |
| Min Value / Max Value | The lowest and highest number allowed. For text, the shortest and longest length |
| Unique | No two employees can have the same value |
| Required | The field must have a value before the record can be saved |
| Enable Demographics | Adds the field to the Demographics report. List type only, at Profile or Education level |
| Display On Org Chart | Shows the value on the org chart. Profile level only |
| Use For Payroll Report Grouping | Lets you group payroll reports by it. Profile level only |
| Record In Lifecycle | Keeps 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
- Use Bulk data import and export to load values for everyone at once.
- 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.