Custom Attributes let you extend the standard data model in Learnster with additional fields tailored to your organisation. Once created, they can be applied to users or course registration forms — and used in reporting, smart assignments, advanced rules, and more. 🧩
Finding Attributes
Go to Studio → Settings → Attributes to view, manage, and create all your custom attributes.
Creating a New Attribute
To create a new custom attribute:
Go to Studio → Settings → Attributes.
Click the New Attribute button at the bottom-left of the list.
Enter an Attribute name.
Select a Type (see below for all available types).
Select the Related entity — either User or Enrollment.
Enable any usage options relevant to your use case.
Click Save Changes.
💡 For Single Choice and Multi Choice types, use the Add value button to define the list of selectable options before saving.
Attribute Types
Choose the type that best matches the kind of data you want to store. The type you select affects which usage options are available and how the attribute can be used across the platform.
Text
A free-text field that stores up to 128 characters. Best suited for descriptive, reference information displayed on user profiles — such as internal notes, certification comments, or HR annotations. Because the value is unstructured, text attributes are not recommended for automation, reporting filters, or advanced rules.
Example use cases: internal reference description, certification notes, additional background information, external HR comments.
Number
Accepts numeric values only. Useful when storing values that may be used in comparisons, sorting, or reporting.
Example use cases: years of experience, age, score, internal employee number, certification level.
Single Choice
Lets the user select one option from a predefined list. Because options are fixed and structured, single choice attributes can be used in reporting, smart assignments, and advanced rules — making them a strong fit for triggering automation or filtering users.
Example use cases: employment type (Full-time, Part-time, Contractor), work shift (Morning, Evening, Night), cost centre.
💡 Boolean tip: A single choice attribute can act as a boolean by defining just one option — for example, an attribute called Finished onboarding with a single option Yes. If set, the condition is true; if empty, it hasn't been fulfilled yet. This works well in advanced rules and smart assignments.
Multi Choice
Lets the user select one or more options from a predefined list. Useful when a user belongs to multiple categories simultaneously. Supports reporting, smart assignments, and advanced rules.
Example use cases: languages spoken, market responsibility (Nordics, DACH, UK), product areas an employee supports.
Date
Stores a calendar date and time value. Date attributes are especially powerful for time-based automation — for example, automatically assigning onboarding training one week after a learner's start date, or triggering an offboarding course when a contract end date is approaching. Can be used in reporting, Smart Enrollment, and Advanced Rules.
Example use cases: employment start date, probation period end date, contract end date, last role change date.
💡 Date attributes are especially useful when training should be triggered relative to a specific lifecycle event — such as onboarding, contract renewal, offboarding, or product milestones.
Related Entity
When creating an attribute, you choose which entity it belongs to:
User — Adds the attribute to the user profile. Use this to store information about your learners, such as hire date, department, job level, or any other organisational data point that adds clarity to reporting and course assignment.
Enrollment — Adds the attribute to course registration forms. Use this to collect participant details when learners sign up for physical events — such as dietary requirements, accommodation needs, or cost centre. Attributes are configured once and can then be added to any relevant registration form.
Usage Options
When creating or editing an attribute, you can enable any of the following options:
Display in UI — The attribute and its value are shown on the user card in Studio, making it visible when reviewing individual learner profiles.
Use in smart assignment — The attribute can be used as a filter condition in Smart Enrollment. Available for Single Choice and Multi Choice types only.
Use in reports — The attribute appears as a column in relevant reports, allowing you to filter and analyse data by this field.
Use in advanced rules — The attribute can be used as a condition in Advanced Rules, enabling automated actions when its value changes or meets a certain condition.
Managing Attributes via API
Custom attributes can also be managed programmatically through the Learnster Public API. This makes it easy to sync attribute values from external systems — such as HR platforms, CRMs, or identity providers — and to trigger training workflows based on external events.
For full technical documentation, visit the Learnster API overview or the Swagger docs at https://your-url.learnster.com/api/public/v1/swagger/.
ℹ️ Custom Attributes are available for all users.