---
title: "Split String Operator"
slug: "split-string-operator"
description: "Learn how to use the Split String operator to efficiently separate values in a string into an array, enhancing data organization in your workflows."
updated: 2025-11-11T16:19:02Z
published: 2025-11-12T14:27:26Z
canonical: "docs.unqork.io/split-string-operator"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unqork.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Split String Operator

UDesignerClassic Designer

![Settings panel for splitting strings with category, label, and separator options.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/image(262).png?sv=2026-02-06&spr=https&st=2026-11-09T16%3A59%3A07Z&se=2026-11-09T17%3A59%3A07Z&sr=c&sp=r&sig=i6fxdFROuymyogwoi8z6iYU1AQZABZoLnQNN98by96M%3D)The **Split String operator** lets you separate values from one string into array values. You’ll use the operator's Info window to designate a separator, which determines where the operator splits the string. A separator is anything from a dash to a comma to a unique string of your choosing. Once you configure your Data Workflow, the operator splits your string wherever it finds that separator. Then, the Split String operator stores your new data as their own array elements.

Let's say your health insurance company wants to track the login timestamps of your end-users. You want to keep logins organized and accessible. The Split String operator can split the timestamp into an array of smaller strings. First, it searches for the separator. Then, it splits your string into separate string values in an array.

You’ll find the Split String operator under the [Value/String](/v1/docs/valuestring-operator-types) group at the left of the [Data Workflow](/v1/docs/data-workflow-component) canvas.

## About the Info Window

Here's a breakdown of each setting in the Info window:

| Setting | Description |
| --- | --- |
| Category | Grayed out and non-adjustable setting indicating the operation type. |
| Label | Sets the label for your operator, displaying below the operator on your Data Workflow canvas. This field is optional, but set a label if you use more than one of the same operator type. A label helps you identify your operators without opening any Info windows. |
| Separator | The point where you want the operator to split your data. These are often some form of punctuation mark, but can also be numbers, a string, or a phrase. Common separators include: `;`, `-`, `:`, `_`, and `,`. |

## Adding a Split String Operator

To see the Split String in action, let's start with a Hidden component. This component stores the UTC login timestamp of your insurance customer. Then, a Data Workflow with a Split String operator splits the timestamp into separate strings.

> [!NOTE]
> These instructions assume you have a new module open, saved, and with a title.

### Configure the Hidden Component

First, you need a [Hidden](/v1/docs/hidden-component) component to store your UTC timestamp.

1. In the Module Builder, drag and drop a **Hidden** component onto your canvas.
2. In the **Property ID** and **Label Text** fields, enter `lastLoginStamp`.
3. Click **Save Component**.

### Configure the Data Workflow Component

Now, add your [Data Workflow](/v1/docs/using-unqorks-dataworkflow) component, bringing your data in using an Input operator. Then, use a Split String operator to separate values in your `lastLoginStamp ` string at each dash [`-`].

1. Drag and drop a **Data Workflow** component onto your canvas, placing it below your `lastLoginStamp` **Hidden** component.
2. In the **Property ID** and **Canvas Label Text** fields, enter `dwfSplitStamp`.

#### Configure the Input Operator

1. Drag and drop an **Input** operator onto your Data Workflow canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Input |
| Component | lastLoginStamp |
| Required | Yes |
| Source | Default |

#### Configure the First Console Operator

This operator displays your data before it’s split.

1. Drag and drop a **Console** operator onto your Data Workflow canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Console |
| Label | Original |
3. Connect the output port (right) of the `lastLoginStamp` **Input** operator to the input port (left) of the `Original` **Console** operator.

#### Configure the Split String Operator

1. Drag and drop a **Split String** operator onto your Data Workflow canvas.
2. Configure the operator's Info window as follows:

| Setting | Value |
| --- | --- |
| Category | Split String Value |
| Label | - |
| Separator | - |
3. Connect the output port (right) of the `lastLoginStamp` **Input** operator to the input port (left) of the **Split String** operator.

#### Configure the Second Console Operator

This operator displays the results of your data after being split.

1. Drag and drop a second **Console** operator onto your Data Workflow canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Console |
| Label | Dash |
3. Connect the output port (right) of the **Split String** operator to the input port (left) of the `Dash` **Console** operator.

![Data workflow interface showing property ID and console elements for string manipulation.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/image(269).png?sv=2026-02-06&spr=https&st=2026-11-09T16%3A59%3A07Z&se=2026-11-09T17%3A59%3A07Z&sr=c&sp=r&sig=i6fxdFROuymyogwoi8z6iYU1AQZABZoLnQNN98by96M%3D)
4. Click **Save Component**.

### Configure the Button Component

Lastly, add a [Button](/v1/docs/button-component) component to trigger your Data Workflow.

1. Drag and drop a **Button** component onto your canvas, placing it between your Hidden and Data Workflow components.
2. In the **Property ID** field, enter `btnSplitStamp`.
3. In the **Label Text** field, enter `Split Timestamp`.
4. From the **Action Type** drop-down, select **Event**.
5. In the **Trigger on Click** field, enter `dwfSplitStamp`.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/image(272).png?sv=2026-02-06&spr=https&st=2026-11-09T16%3A59%3A07Z&se=2026-11-09T17%3A59%3A07Z&sr=c&sp=r&sig=i6fxdFROuymyogwoi8z6iYU1AQZABZoLnQNN98by96M%3D)
6. Click **Save Component**.
7. **Save** your module.

Here's how the completed example looks in the Module Builder:

![User interface displaying last login and split timestamp options for data management.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/image(271).png?sv=2026-02-06&spr=https&st=2026-11-09T16%3A59%3A07Z&se=2026-11-09T17%3A59%3A07Z&sr=c&sp=r&sig=i6fxdFROuymyogwoi8z6iYU1AQZABZoLnQNN98by96M%3D)

Preview your module in Express View and open the DevTools Console. Then, click the **Split Timestamp** button. In the Console, you see updates from your two Console operators. The `Original` **Console** shows you the original string you stored in your Hidden component. When you expand the `Dash` **Console** array, you can see how the original string is split into an array of four string values. Because you entered the dash as the separator, your original string is separated at each dash symbol.

![Console output showing last login details and a button to split timestamps.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/DWF_Split_String_06.jpg?sv=2026-02-06&spr=https&st=2026-11-09T16%3A59%3A07Z&se=2026-11-09T17%3A59%3A07Z&sr=c&sp=r&sig=i6fxdFROuymyogwoi8z6iYU1AQZABZoLnQNN98by96M%3D)

![Diagram illustrating the split string function with category, label, and separator fields.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/DWF_Split_String_01.jpg?sv=2026-02-06&spr=https&st=2026-11-09T16%3A59%3A07Z&se=2026-11-09T17%3A59%3A07Z&sr=c&sp=r&sig=i6fxdFROuymyogwoi8z6iYU1AQZABZoLnQNN98by96M%3D)The **Split String operator** lets you separate values from one string into array values. You’ll use the operator's Info window to designate a separator, which determines where the operator splits the string. A separator is anything from a dash to a comma to a unique string of your choosing. Once yStou configure your Data Workflow, the operator splits your string wherever it finds that separator. Then, the Split String operator stores your new data as their own array elements.

Let's say your health insurance company wants to track the login timestamps of your end-users. You want to keep logins organized and accessible. The Split String operator can split the timestamp into an array of smaller strings. First, it searches for the separator. Then, it splits your string into separate string values in an array.

You’ll find the Split String operator under the [Value/String](/v1/docs/valuestring-operator-types) group at the left of the [Data Workflow](/v1/docs/data-workflow-component) canvas.

## About the Info Window

Here's a breakdown of each setting in the Info window:

| Setting | Description |
| --- | --- |
| Category | Grayed out and non-adjustable setting indicating the operation type. |
| Label | Sets the label for your operator, displaying below the operator on your Data Workflow canvas. This field is optional, but set a label if you use more than one of the same operator type. A label helps you identify your operators without opening any Info windows. |
| Separator | The point where you want the operator to split your data. These are often some form of punctuation mark, but can also be numbers, a string, or a phrase. Common separators include: `;`, `-`, `:`, `_`, and `,`. |

## Adding a Split String Operator

To see the Split String in action, let's start with a Hidden component. This component stores the UTC login timestamp of your insurance customer. Then, a Data Workflow with a Split String operator splits the timestamp into separate strings.

> [!NOTE]
> These instructions assume you have a new module open, saved, and with a title.

### Configure the Hidden Component

First, you need a [Hidden](/v1/docs/hidden-component) component to store your UTC timestamp.

1. In the Module Builder, drag and drop a **Hidden** component onto your canvas.
2. In the **Property ID** and **Canvas Label Text** fields, enter `lastLoginStamp`.
3. Click **Save & Close**.

### Configure the Data Workflow Component

Now, add your [Data Workflow](/v1/docs/using-unqorks-dataworkflow) component, bringing your data in using an Input operator. Then, use a Split String operator to separate values in your `lastLoginStamp ` string at each dash [`-`].

1. Drag and drop a **Data Workflow** component onto your canvas, placing it below your `lastLoginStamp` **Hidden** component.
2. In the **Canvas Label Text** and **Property Name** fields, enter `dwfSplitStamp`.

#### Configure the Input Operator

1. Drag and drop an **Input** operator onto your Data Workflow canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Input |
| Component | lastLoginStamp |
| Required | Yes |
| Source | Default |

#### Configure the First Console Operator

This operator displays your data before it’s split.

1. Drag and drop a **Console** operator onto your Data Workflow canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Console |
| Label | Original |
3. Connect the output port (right) of the `lastLoginStamp` **Input** operator to the input port (left) of the `Original` **Console** operator.

#### Configure the Split String Operator

1. Drag and drop a **Split String** operator onto your Data Workflow canvas.
2. Configure the operator's Info window as follows:

| Setting | Value |
| --- | --- |
| Category | Split String Value |
| Label | - |
| Separator | - |
3. Connect the output port (right) of the `lastLoginStamp` **Input** operator to the input port (left) of the **Split String** operator.

#### Configure the Second Console Operator

This operator displays your data after being split.

1. Drag and drop a second **Console** operator onto your Data Workflow canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Console |
| Label | Dash |
3. Connect the output port (right) of the **Split String** operator to the input port (left) of the `Dash` **Console** operator.

![Data workflow options showing input, output, and console components for processing.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/DWF_Split_String_04.jpg?sv=2026-02-06&spr=https&st=2026-11-09T16%3A59%3A07Z&se=2026-11-09T17%3A59%3A07Z&sr=c&sp=r&sig=i6fxdFROuymyogwoi8z6iYU1AQZABZoLnQNN98by96M%3D)
4. Click **Save**.

### Configure the Button Component

Next, add a [Button](/v1/docs/button-component) component to trigger your Data Workflow.

1. Drag and drop a **Button** component onto your canvas, placing it between your Hidden and Data Workflow components.
2. In the **Property ID** field, enter `btnSplitStamp`.
3. In the **Label Text** field, enter `Split Timestamp`.
4. Set the **Action Type** as **Event**.
5. In the **Trigger on Click** field, enter `dwfSplitStamp`.

![Button settings for a workflow module with action types and event ID fields.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/DWF_Split_String_05.jpg?sv=2026-02-06&spr=https&st=2026-11-09T16%3A59%3A07Z&se=2026-11-09T17%3A59%3A07Z&sr=c&sp=r&sig=i6fxdFROuymyogwoi8z6iYU1AQZABZoLnQNN98by96M%3D)
6. Click **Save & Close**.
7. **Save** your module.

Here's how the completed example looks in the Module Builder:

![Module editor interface displaying string splitting functionality and options for processing.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/DWF_Split_String_02.jpg?sv=2026-02-06&spr=https&st=2026-11-09T16%3A59%3A07Z&se=2026-11-09T17%3A59%3A07Z&sr=c&sp=r&sig=i6fxdFROuymyogwoi8z6iYU1AQZABZoLnQNN98by96M%3D)

Preview your module in Express View and open the DevTools Console. Then, click the **Split Timestamp** button. In the Console, you see updates from your two Console operators. The `Original` **Console** shows you the original string you stored in your Hidden component. When you expand the `Dash` **Console** array, you can see how the original string is split into an array of four string values. Because you entered the dash as the separator, your original string is separated at each dash symbol.

![Console output displaying last login details and a button to split timestamp.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/DWF_Split_String_06.jpg?sv=2026-02-06&spr=https&st=2026-11-09T16%3A59%3A07Z&se=2026-11-09T17%3A59%3A07Z&sr=c&sp=r&sig=i6fxdFROuymyogwoi8z6iYU1AQZABZoLnQNN98by96M%3D)

A string is an object that represents a sequence of characters. Strings typically hold data represented in text form.

End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product.

Coordinated Universal Time (UTC) is a standard, globally-accepted timezone used to regulate clocks and time around the world.

Triggers activate another component when certain requirements are met. Trigger types include Concurrent, Post, and Error. Some components do not have the ability to trigger others.

The Unqork front-end application framework that delivers Creator-built applications to end-users. Express is the layer end-users interact with—the published forms, screens, and navigation built in the Module Builder. Express is distinct from Express View, which is a Creator-facing preview tool in the IDE.

The DevTools Console helps you securely store, build, test, and deploy your software.

## Related

- [Introduction to the Workflow Builder](/introduction-to-workflow.md)