Skip to content

Profiles and Profile Groups

In this article, we explain how Profiles and Profile Groups work in the Regula IDV Platform, including their structure, configuration, and access management.

A Profile is a collection of facts about a Person, which includes:

  • A set of required individual fields
  • A set of document IDs linked to the Person, processed with the Document Reader SDK
  • Biometric data
  • Any binary files (photos and documents not processed by the Document Reader SDK) associated with the Profile
  • A complete history of creation and modifications of all Profile data

Profile Groups

Profiles can be organized into Groups — collections of Profiles that share a common data structure. The purpose of grouping is to align Profiles with business requirements.

You will benefit from grouping if:

  • You need specific sets of required fields that may vary depending on the business process.
  • You want to enforce access control so that only certain Roles can view or edit specific Profiles.

Group configuration

When creating a Group, the following information is defined:

  • Name — group name
  • Description — group description
  • Attributes — list of fields used in the group
  • Summary — data fields displayed in the summary section

Attributes

Attributes are fields that can be filled in each Profile. Their type and number depend on the business process.

Each field has the following parameters:

  • ID (required) — unique identifier
  • Name — human-readable identifier
  • Description — field description
  • Type — field data type

Supported field types:

  • general — free text, suitable for most cases
  • date — formatted date
  • email — email format
  • phone — phone number format
  • document — document file processed by the Document Reader SDK
  • biometrics — biometric-related photos
  • binary — arbitrary binary file

If the type is not specified, it defaults to general.

Summary

A Summary is a set of fields displayed in the Profile’s summary section. Only fields from Attributes can be selected, and only text-based fields are supported (document, biometrics, and binary are excluded).

Views

Profile Views work the same way as Views for Sessions. By default, the All View is available. Views can be configured with:

  • Table columns
  • Filters
  • Sorting options

Access Control for Profile Groups

To work with Profiles, a new Role called Profile Reviewer is required.

  • Profile Reviewer has access to Profiles and sessions.
  • By default, they can access only the Default Group. Access to other Groups must be explicitly granted.
  • Profile Reviewer can only view existing groups, not create, edit, or delete them.
  • They can create custom views within groups.

Access management for Profile Groups works similarly to access control for Views and Workflows.

Within a Group, a User has access to all Profiles, but specific actions can be restricted:

  • Create new Profile
  • View Profile
  • Delete Profile
  • Change status
  • Edit data
  • Load new data
  • Start additional verification from Profile
  • Export Profile
  • Download attachments

For more details, see the User Management page.

Profile List

The Profile list is a table where each row represents one Profile.

  • The status column is always present and listed first.
  • A search bar allows searching across all available attribute values.
  • The list behaves like a view and can be configured with filters, sorting, and custom columns.

Interacting with Profiles

Profiles can be created and populated in two ways:

  • Manual input — data entered by an authorized User via UI or API (records the account name)
  • Workflow — data populated automatically through a Workflow (records the workflow name and session link)

Data in a Profile changes only through manual or workflow interactions.

Automatic interaction

Workflows can interact with Profiles through a new person action type. This action supports:

  • Creating a new Profile in a Group
  • Searching Profiles within a Group using session data (biometric or textual)
  • Updating existing Profiles
  • Extracting data from an existing Profile into a session

Manual interaction

When manually creating a Profile, an Administrator can:

  • Fill in required fields defined for the Group
  • Upload and process an ID document with the Document Reader SDK
  • Upload arbitrary documents not processed by the Document Reader SDK
  • Upload photos

Additional verifications

An administrator with proper rights can start additional verification by launching a new workflow session. Profile data is passed into the session as input.

Profile Data Structure

The Profile screen is divided into two sections:

  • Summary
  • Info tabs

Summary

The Summary works similarly to the session Summary. It includes:

  • Title — a composite field from one or more Profile fields
  • Photo — selected from available photos
  • Field list — chosen Attributes always visible in summary
  • Created at — Profile creation timestamp
  • Last updated — last modification timestamp

Info tabs

The lower section contains tabs. The Data tab is open by default.

Data

Contains all field data except documents, photos, and binary files. The tab is organized as a table:

  • Name — field name
  • Value — field value
  • Created by — manual input or workflow
  • Created at — timestamp (with a link to the related timeline event)

ID documents

Includes all documents processed with the Document Reader SDK. Each document field groups related documents, e.g.:

  • Passports
  • Driver’s licenses

Each document card includes:

  • Processed with the Document Reader SDK results
  • Created at
  • Created by
  • Timeline link
  • Expand button for details

Biometrics

Contains all biometric photos, structured by field, such as:

  • Selfie
  • Fingerprints
  • Retina

Each biometric entry includes:

  • Current photo (latest uploaded)
  • Created by (manual input + User or Workflow + name)
  • Timestamp
  • Timeline link
  • Option to view previous photos

Attachments

Stores arbitrary files linked to the Profile. Each attachment includes:

  • File name
  • Comment
  • Created by
  • Created at
  • File size
  • Links to timeline and session
  • Download option

Sessions

Displays all sessions that created, modified, or used the Profile. Each session entry includes:

  • Current status
  • Workflow name
  • Workflow ID (with link)
  • Start date
  • End date (if completed)

Deleted sessions are not listed.

Timeline

A detailed log of all Profile-related events, including:

  • Profile creation
  • Settings changes
  • Data changes
  • Workflow launches
  • Status updates

Each event shows:

  • Event type
  • Method (manual or automatic)
  • Author (User or Workflow)
  • Timestamp
  • Previous and new values (if applicable)

The timeline includes a search bar to filter events by:

  • Workflow/session name or ID
  • Administrator name
  • Date
  • Field name
  • Field value (current or historical)