The Timer component displays a countdown or count-up timer to end-users and fires a when the duration completes. Use it for session timeouts, quiz timers, or any time-limited interaction.
How to read settings tables
The tables below describe each configurable option as it displays in the UnqorkAI platform. Values are formatted as follows:
inline code— a value to type exactly as shown | Bold — a value selected from a drop-down, radio button, tab, or choice chip | ON/OFF — toggle state | ✓ — checkbox checked | ☐ — checkbox unchecked
General Settings
Setting | Field | Type | Default | Description |
|---|---|---|---|---|
Property ID |
| Text input |
| The unique identifier for this component instance. |
Display Settings
Field Text
Setting | Field | Type | Default | Description |
|---|---|---|---|---|
Label Text |
| Text input | — | Identifies the component on the canvas and displays the timer label. |
Contextual Help
Setting | Field | Type | Default | Description |
|---|---|---|---|---|
Tooltip |
| Text input | — | A brief description that displays when a cursor is positioned over the tooltip icon. |
Helper Text |
| Text input | — | A single line of guidance text that always displays below the timer. |
Default State Options
Setting | Field | Type | Default | Description |
|---|---|---|---|---|
Hide Label |
| Toggle | OFF | Hides the label. The label remains visible in the Module Builder. |
Hide Field |
| Toggle | OFF | Hides the timer from end-users. The timer continues running invisibly. Always displays in the Module Builder. |
Formatting
Setting | Field | Type | Default | Description |
|---|---|---|---|---|
Set Timer Duration |
| Number input |
| The timer duration in seconds. |
Timer Direction |
| Radio button | Count Down | Sets whether the timer counts down from the duration or counts up to it. Options include: Count Down or Count Up. |
Set Time Format |
| Text input |
| The display format for the timer using moment.js tokens. Surround static text with square brackets (for example, |
Reset When User Activity is Detected |
| Toggle | OFF | Resets the timer whenever the end-user interacts with the page. |
Data Settings
Data Storage
Setting | Field | Type | Default | Description |
|---|---|---|---|---|
Store Data in Database |
| Toggle | ON | When set to ON, this setting this setting stores field values to the database when the module saves, end-users navigate between Panel components, or end-users navigate between workflow screens. Set to OFF to exclude this field from server-side submissions. |
↳ Continue Where User Left Off |
| Toggle | OFF | Resumes the timer from the remaining time stored in the submission. Visible when Store Data in Database is ON. |
Fields with Store Data in Database set to OFF are excluded from Plug-In component's API responses and Unqork's built-in tracker. When using a Plug-In component to remote-execute a module, any component whose value must be included in the API response requires Store Data in Database set to ON.
Actions Settings
Triggers
Setting | Field | Type | Default | Description |
|---|---|---|---|---|
Trigger |
| Property ID | — | Triggers another component when the timer reaches zero (or the set duration when counting up). |
Advanced Settings
Additional Styling
Setting | Field | Type | Default | Description |
|---|---|---|---|---|
Custom CSS Class |
| Text input | — | A CSS class applied to the component for custom styling. |
Operations Builder
This component supports the Operations Builder in Vega modules. When the module or panel runtime is set to Vega (2.0), an Event Handlers section displays in the settings panel for configuring event-driven operations.
Changelog
Date | Change |
|---|---|
— | Initial publication. |