WorksheetFunction.Substitute method (Excel)

Substitutes new_text for old_text in a text string. Use Substitute when you want to replace specific text in a text string; use Replace when you want to replace any text that occurs in a specific location in a text string.

Syntax

expression.Substitute (Arg1, Arg2, Arg3, Arg4)

expression A variable that represents a WorksheetFunction object.

Parameters

Name	Required/Optional	Data type	Description
Arg1	Required	String	Text - the text or the reference to a cell containing text for which you want to substitute characters.
Arg2	Required	String	Old_text - the text that you want to replace.
Arg3	Required	String	New_text - the text that you want to replace old_text with.
Arg4	Optional	Variant	Instance_num - specifies which occurrence of old_text you want to replace with new_text. If you specify instance_num, only that instance of old_text is replaced. Otherwise, every occurrence of old_text in text is changed to new_text.

Return value

String

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.