Edmissa docs

Field Configuration

Understand the settings available for each field type.

Field configuration controls how a field behaves after the basic details are set. The available settings depend on the field type.

Basic Tab Settings

The student field wizard starts with Basic.

SettingWhat it controls
Field CategoryThe group of field types, such as Basic Fields or Compound Fields.
Field TypeThe input type users will work with.
Display LabelThe name users see in forms and views.
Field NameThe system key generated from the label. Review it before saving.
Help TextA short instruction shown to users.
Field GroupThe group where the field belongs.
Required FieldWhether the value must be provided before the relevant form can be completed.

Choose the field type carefully. Once a field is in use, changing its type can break existing data and connected workflows.

Simple Field Configuration

Most basic student fields show:

SettingUse it for
Placeholder TextHint text shown before a value is entered.
Default ValueA value that is filled automatically for new records.

Application fields include Placeholder Text and Help Text in the main creation dialog.

Option Fields

Dropdown, Multi Select, and Radio Buttons use options.

Option sourceUse it for
Manual OptionsEnter a short list directly in the field settings.
DatasetUse a managed list and optionally allow or exclude specific items.
Lead SourcesUse the values from Lead Sources settings. This is available for student fields.

Manual options are best for small lists that rarely change. Datasets are better for longer lists, shared lists, or lists that need central management.

Dropdown field configuration with manual destination options.
Use manual options when a field has a short fixed list, such as preferred study destinations.

Currency Fields

Currency fields can be configured with:

SettingWhat it controls
Currency SourceUse the location default currency or choose one specific currency.
Show Currency SymbolShow or hide the currency symbol.
Allow Negative ValuesDecide whether users can enter amounts below zero.

Use location default currency when different branches work in different currencies. Use one specific currency when the field always refers to the same currency.

Phone Fields

Phone fields can be configured with:

SettingWhat it controls
Allowed CountriesAllow all countries, specific countries, or one country only.
Phone Type RestrictionAccept mobile numbers, landline numbers, or both.
Default CountryPreselect the country when the field is empty.
Show Country CodeShow values such as +971.
Show Country FlagShow or hide the country flag.
Custom PlaceholderOverride the hint text shown in the empty phone field.

Use country restrictions when the agency only accepts phone numbers from a specific operating region.

Address Fields

Address fields are structured fields. They can include Street Address, Street Address 2, City, State or Province, Postal Code, and Country.

Address configuration can control:

SettingWhat it controls
Subfield visibilityWhich address parts users see.
Subfield requirementWhich visible address parts users must fill.
Country optionsAllow all countries, restrict to selected countries, or lock to one country.
City input typeUse free text or a dropdown list.
State input typeUse free text or a dropdown list.
Custom labelsRename address parts for your region.
Custom placeholdersChange the hint text for each address part.

For dropdown city or state values, admins can import several options at once.

File And Image Upload Fields

File Upload and Image Upload fields use Document Type settings.

The selected Document Type controls file rules such as accepted formats and maximum file size. Set up document types before adding upload fields.

Compound And Custom Groups

Field Group and Repeating Group fields can use either:

ModeUse it for
TemplateUse a prebuilt group. This is the recommended mode when the template matches the need.
Custom SubfieldsBuild your own group with subfields.

Custom subfields can use Text, Number, Date, Date & Time, Time, Dropdown, Checkbox, Email, Phone, URL, Text Area, and Currency.

After a group is created, existing subfield keys and types should be treated as locked because they protect existing data. Labels and guidance can still be improved.

Repeating Behavior

Repeating Field and Repeating Group settings can include:

SettingWhat it controls
Minimum InstancesThe fewest entries users must add.
Maximum InstancesThe most entries users can add.
Add Button LabelThe label on the add action.
Remove Button LabelThe label on the remove action.
Empty State TextText shown before any entry is added.
Instance Label PatternHow each repeated entry is named.
Allow ReorderingWhether users can drag entries into a new order.
Collapse InstancesWhether entries can open and close like an accordion.
Collapsed By DefaultWhether entries start closed.

Repeating Field also asks for the base field type. The base type can be Text Input, Number, Email, Phone, URL, Date, Date & Time, Time, Text Area, Currency, Dropdown, or Multi Select.

GuideUse it for
Field categories and typesChoose the correct field type.
Field typesReview each individual field type before configuring it.
ValidationAdd required and value rules.
Display configurationDecide where the field appears after it exists.