System values

Prev Next

System values are data points that Lightico automatically generates or records during a session, case, or process — such as the customer's name, the agent handling the interaction, IDs assigned to sessions or documents, and the current date. Unlike Attributes, which capture information provided by users, system values are maintained by the platform itself and always reflect accurate, real-time data.

Where system values are used

System values are available throughout the platform wherever dynamic data can be inserted. Common uses include:

  • Document content — embed session or customer details directly into Dynamic Documents and HTML documents

  • File names and footers — build structured, automatically populated file names and footer text for completed documents and IDV images; for PDF Templates, system values are also used to define the document code in the template settings

  • Workflow conditions — drive branching logic in Workflows based on session data, case ownership, IDV results, or the current date

  • Case Manager conditions — control lifecycle transitions and task behavior based on case state, ownership, or other session data

How system values appear

System values appear in the format #VALUE_NAME# and are selected from a menu wherever system values are supported.

Scope and context

Not every system value applies to every context. For example, case-related values such as #CASE_STATE_NAME# are only relevant in Case Manager, while document-related values such as #PAGE_COUNT# apply only where documents are involved. This article provides the full list of available system values across the platform.

System value reference

The following is the complete list of system values available in Lightico. Not all values are relevant in every context — values specific to Case Manager, for example, will not be applicable in a document file name, and document-specific values are not used in Case Manager conditions. Use the descriptions to identify which values are relevant for your use case.

You can select the following system values:

  • #CASE_ASSIGNED_BY_NAME# – Full name of the user who assigned the case

  • #CASE_OWNER_FULL_NAME# – Full name of the assigned case owner

  • #CASE_OWNER_NAME# – Username (email) of the assigned case owner

  • #CASE_STATE_ID# – Unique identifier of the current case lifecycle state; recommended for stable condition logic

  • #CASE_STATE_NAME# – Display name of the current case lifecycle state

  • #CASE_TITLE# – Name given to the case

  • #CASE_TYPE_ID# – Unique identifier of the case type

  • #CASE_TYPE_NAME# – Name of the case type

  • #CURRENT_DATE# – Today's date at the time of evaluation

  • #CUSTOMER_CONTACT# – Customer's email address or phone number

  • #CUSTOMER_NAME# – Customer's name used in the session

  • #DOCUMENT_CODE# – Defined by the BC for each document:

    • For PDF Templates and overlays in the settings tab

    • For Dynamic Documents from the menu in the upper right corner

  • #DOCUMENT_REQUEST_NAME# – Referred to as "Document name" in the Admin Center Document requests page

  • #DOCUMENT_REQUEST_TYPE# – Referred to as "Category name" in the Admin Center Document requests page

  • #FILE_ID# – Unique number that identifies a document after it has been added to a session

  • #FILE_NAME# – Name of the document file

  • #IDV_DOCUMENT_CLASS# – The document class identified during a photo IDV step; possible values: Driver's license, Passport, Identification card, ICAO passport card, Residence permit

  • #IS_CASE_OWNER# – Boolean value that evaluates whether the current user is the assigned case owner (true/false)

  • #PAGE_COUNT# – Number of pages in a document

  • #PAYMENT_ID# – Unique identifier of a payment transaction

  • #ROLE_ID# – Unique identifier of the user's role

  • #ROLE_NAME# – Name of the user's role

  • #SESSION_CREATION_DATE# – Date the session was created

  • #SESSION_ID# – Unique identifier of the session

  • #TEAM_ID# – Unique identifier of the user's team

  • #TEAM_NAME# – Name of the user's team

  • #TEMPLATE_ID# – Unique number that identifies a document or workflow template

  • #TEMPLATE_NAME# – Name given to a document template in the PDF Editor

  • #UNIQUE_24CHARS# – Lightico-generated unique 24-character string, assigned when a file is completed

  • #USER_NAME# – Agent's name

  • #WORKFLOW_ID# – Unique number that identifies a workflow after it has been added to a session

  • #WORKFLOW_NAME# – Name given to the workflow in the Workflow Builder