Additional properties are customisable fields that can be added to the employee feed or to the opportunities feed in 365Talents.
What is an additional property?
An additional property is a field that is not part of the standard 365Talents data model — it is therefore not mandatory for the platform to operate. Such fields can be added on demand, depending on the customer's needs, either on the employee feed or on the opportunities feed.
What are they used for?
- Acting as additional filters in the directories (employee directory, opportunities directory).
- Attaching values directly to employee profiles or to opportunities, to display them, use them in matching rules or expose them through the API.
- Extending the 365Talents data model without touching the standard fields.
Concrete example: contract type on the employee feed
Imagine the customer wants to display and filter employees by contract type. Contract type is not a standard 365Talents field, but it can be stored as an additional property.
- The employee feed carries the value (e.g. "Permanent" or "Fixed-term") in a dedicated column.
- On the 365Talents side, that column is mapped to a new additional property called, for example, contract_type.
- The value is then visible on the employee profile, can be used as a filter in the directories and is accessible via the API.
How are values populated?
Additional properties behave like list fields. They are populated directly by the feed: there is no need to pre-create the allowed values manually before the first import.
Automatic value creation: if a value transmitted by the feed does not yet exist in the list, it is automatically created from the feed value. The employee (or opportunity) is attached to this new value at the same time.
Illustration
- Initial state: every employee carries the value "Fixed-term". The additional property list therefore contains only "Fixed-term".
- The next feed adds a new employee with the value "Permanent".
- Since "Permanent" does not exist in the list yet, the value is created automatically and attached to the employee.
- The list now contains "Fixed-term" and "Permanent", available as filters in the directories.
Limits & format
| Topic | Rule |
|---|---|
| Field type | List field, populated by the feed. Values are automatically created from incoming values. |
| Maximum value length | 255 characters per value. The limit applies per value — including in the multi-value case (each individual value must stay under 255 characters). |
| Multi-value | Several values can be attached to the same employee or to the same opportunity. In the feed, values must be separated by a semicolon (;) to be detected as multi-value. |
| Renaming | An additional property's display label can be renamed in any of the supported languages (display label only). |
| API access | Each additional property is exposed in the 365Talents APIs inside an additionalProperties array, identified by its code name (technical key). |
Multi-value format in the feed
In the employee (or opportunity) feed, a multi-value additional property is written by concatenating the values separated by a semicolon. Example for an additional property certifications:
certifications: "AWS Solutions Architect;Azure Fundamentals;PMP"
Each value is then recognized individually and attached to the employee. In this example, the employee is linked to three distinct values.
Use as a tag
An additional property can also be used as a tag. In that display mode, the values carried by the additional property appear directly on the employee profile or on the opportunity as visual labels, easy to spot at a glance.
The way values are populated stays the same (automatic creation from the feed, multi-value separated by a semicolon, 255-character limit per value). Only the display mode changes: the data is highlighted as a tag instead of being shown as a plain list field.
- Ideal to visually surface key information (certifications, badges, specific statuses, dedicated populations…).
- The same additional property can serve both as a filter in the directories and as a visual tag on the profile.
- The display mode (regular field or tag) is chosen at the time the additional property is configured.