As a school administrator, gathering comprehensive information about your users during the sign-up process is crucial. Besides the essential fields such as Email, Username, and Password, LearnWorlds also offers the ability to create your own user fields.
User fields are important because they allow you to collect specific information tailored to your institution's needs, enabling a more personalized and efficient user experience.
In this article, we will explore how to create user fields and examine some practical use cases for their implementation.
Use Cases
User fields help you collect additional details beyond the required basics (Email, Name, Username, Password). This information supports better management, personalization, and segmentation.
For example, you can collect information on:
Birthday → Send learners a birthday coupon or special offer.
Demographics (e.g., gender, age group, profession) → Segment learners and deliver targeted content or newsletters.
Address → Ship physical products when needed (or request later via Marketing Forms).
Keep sign-up simple by asking only for essential details. You can always gather more information later through Marketing Forms.
How to Create a User Field
1. To create a new user field:
- Go to Users → User Fields and click Create user field.
- Go to Website → Website Settings → Authentication → Learnworlds → Click Add field → Create new user field.
2. Choose the Field Type between:
- Short text
- Long text
- Country
- Date
- Dropdown
- Checkbox
- Radio buttons
3. Fill in the needed details like field type, usage, label, or view and edit permissions.
4. Click the Save button to activate the field.
Types of User Field Options
Text input
Best for simple, open-ended answers like names, goals, or short descriptions.
Configuration Options:
- Field Type: Choose the input type for the field (e.g., Short text, Long text, Date, Country, etc.).
- Save as: Enter a name to help you identify this field later.
- Data key: Used in APIs and integrations — optional, only needed for custom identifiers.
- Field Usage: Choose if you want to include the field in the signup form. Toggle ON/OFF, determines if the field is shown during signup, makes this field visible on the signup form, and mark it as required.
- Field label: The label that appears above the field in the signup form.
- Input placeholder: Text shown inside the field when it’s empty.
- Preview: A live preview of how the field will appear.
- Default value: Option to store a specific default value if left blank, and add a default value (text input).
- Input character limit: Set the maximum number of characters allowed.
- Validation Rules: Add rules to control the type of input, such as:
-Alphanumeric
-URL
-Numbers only
You can also set a constraint failure error message if the constraint validation fails:
- Custom regular expression (regex): For more information on what they are and how to create them, check this article.
- Role-based permissions: Choose which user roles can view or edit the field.
Click on Create, and your user field is ready.
Country
Presents a pre-filled dropdown list of all countries.
Configuration Options:
- Field Type
- Save as: Enter a name to help you identify this field later.
- Data key
- Field Usage: Include the field in the signup form. Choose whether the field is visible during signup:
-Toggle ON/OFF – display this field in the signup form.
-Make this field visible on the signup form.
-Mark this field as required.
- Field label: Text label displayed above the field (e.g., “Where do you live?”).
- Selector placeholder: Placeholder text shown inside the dropdown before a country is selected (e.g., “Select your country”).
- Preview: Displays how the field will appear to users.
- Default value: Option to store a specific default value if left blank, and a dropdown list to select a default country.
- Add user input as a tag: User input to this field will be added as a tag to the user profile.
- View and Edit Permissions
The country list is built-in and cannot be manually modified.Date
Allows users to select a date, optionally with time. This option is useful for birthdates, membership start dates, or deadlines.
Configuration Options:
- Field type
- Save as: A name to help identify this field internally (e.g., user_birthday or start_date).
- Data key: Used in APIs and integrations. This is auto-generated if left blank. Only edit this if a custom identifier is required.
- Field Usage: Include the field in the signup form. Choose whether the field is visible during signup:
-Toggle ON/OFF – display this field in the signup form.
-Make this field visible on the signup form.
-Mark this field as required.
- Field label: The label shown above the date field (e.g., “Birthday”, “Enrollment Date”).
- Input placeholder: Optional text displayed when the field is empty (e.g., “Select a date”).
- Preview: Displays how the field appears to users.
- Date Range
- View and Edit Permissions
-You can enable a time selection with a date option.Dropdown
Allows users to choose one value from a list of options. Use dropdowns when you have a defined list of answers to choose from.
Configuration Options:
- Field Type
- Save as: Enter a name to help you identify this field later.
- Data key: Used in APIs and integrations. Only edit if you need a custom identifier.
- Field Usage: Include the field in the signup form. Choose whether the field is visible during signup:
-Toggle ON/OFF – display this field in the signup form.
-Make this field visible on the signup form.
-Mark this field as required.
- Field label: Text label displayed above the field (e.g., “Where do you live?”).
- Selector placeholder: Placeholder text shown inside the dropdown before a country is selected (e.g., “Select your country”).
- Options: Add the choices users will see. They will be able to select only one.
- Preview: Displays how the field will appear to users.
- Add user input as a tag: User input to this field will be added as a tag to the user profile.
- View and Edit Permissions
Checkbox
Allow users to tick a box to confirm or agree to something. You can use it for terms acceptance, newsletter sign-up, or yes/no opt-ins.
Configuration Options:
- Field Type
- Save as: Enter a name to help you identify this field later.
- Data key: Used in APIs and integrations. Only edit if you need a custom identifier.
- Field Usage: Include the field in the signup form. Choose whether the field is visible during signup:
-Toggle ON/OFF – display this field in the signup form.
-Make this field visible on the signup form.
-Mark this field as required.
- Checkbox label: Text that appears next to the checkbox. Use a clear, action-based phrase.
- Default value: Choose whether to store a default value for this field when the field is left blank.
- Add user input as a tag: User input to this field will be added as a tag to the user profile.
- View and Edit Permissions
Radio buttons
Let users choose one option from a visible list. Use radio buttons when you want to display all choices upfront instead of using a dropdown.
Configuration Options:
- Field Type
- Save as: Enter a name to help you identify this field later.
- Data key: Used in APIs and integrations. Only edit if you need a custom identifier.
- Field Usage: Include the field in the signup form. Choose whether the field is visible during signup:
-Toggle ON/OFF – display this field in the signup form.
-Make this field visible on the signup form.
-Mark this field as required.
- Field label: Text label displayed above the field (e.g., “Where do you live?”).
- Options: Add the choices users will see. They will be able to select only one.
- Preview: Displays how the field will appear to users.
- Add user input as a tag: User input to this field will be added as a tag to the user profile.
- View and Edit Permissions
User Fields are not available in the Mobile Apps.