ReplaceList()

Replaces one or more substrings with another string.

This function became available in Marketing Cloud Next during the Summer ’26 release (API version 67.0).

1ReplaceList(sourceString, replacementString,
2            searchString1, [searchString2], ...)

The ReplaceList() function has three parameters:

• sourceString (string): Required. The string to search.
• replacementString (string): Required. The replacement string.
• searchString1 (string): Required. The string to find.

You can search for more than one substring by appending additional parameters. You can add as many search strings as necessary.

This example removes delimiting characters (|, ;, and ,) from a string of text. It replaces the delimiters with a string of text that makes the complete list easier to read.

1%%[
2  Var @hobbies, @hobbiesList
3  Set @hobbies = "biking|cooking;travel,gardening"
4  Set @hobbiesList = ReplaceList(@hobbies,
5                                 ", ", /* Replacement string */
6                                 "|", ";", ",") /* Delimiters */
7]%%
8<p>Your favorite hobbies are: %%=v(@hobbiesList)=%%.</p>

The function returns a string in which the delimiting characters have been replaced with the replacement string.

1Your favorite hobbies are: biking, cooking, travel, gardening.