Use the GetValueByRegex component

---
title: Use the GetValueByRegex component
description: Specify a regular expression and characters to find characters that match by using the GetValueByRegex component in RPA Desktop Design Studio.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/integrate-applications/use-utilities-stringutilities-getvaluebyregex.html
release: australia
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [String utilities, Utilities, Automation components, RPA Desktop Design Studio, Robotic Process Automation \(RPA\) Hub, Workflow Data Fabric]
---

# Use the GetValueByRegex component

Specify a regular expression and characters to find characters that match by using the GetValueByRegex component in RPA Desktop Design Studio.

## Before you begin

Role required: none

## About this task

You can configure the properties for the GetValueByRegex component. For more information about these properties, see [Properties of the String Utilities components](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/util-stringutil-prop.md).

## Procedure

1.  In the Toolbox pane, navigate to **Utilities** > **String Utilities**.

2.  Drag the GetValueByRegex component to the Design surface.

3.  To configure the input fields, see [Configure port properties](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/configure-input-port-properties.md).

4.  Connect the data and control ports of the GetValueByRegex component to the corresponding ports of the other components as described in the following table.

    |Port type|Purpose of connection|Mandatory?|
    |---------|---------------------|----------|
    |Data In \(Text\)|Takes the text from a previously executed component.|Yes|
    |Data In \(RegExpression\)|Takes the regular expression from a previously executed component.|Yes|
    |Data Out \(Boolean\)|Returns the status of the regular expression matching in Boolean and passes to the next component.|Yes|
    |Data Out \(List 1\)|Returns the matched value.|Yes|
    |Control In|Connects to the Control Out port of one or more components.|Yes|
    |Control Out|Connects to the Control In port of another component or the default end component.|No|

5.  To test the component, under the **DESIGN** tab, click **Run**.


**Parent Topic:**[String utilities](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/string-utilities.md)