Practice free

VALUETOTEXT function

VALUETOTEXT converts any value into text and returns it. Strict mode adds quotes so you can tell text from numbers, and errors are converted to text instead of propagating.

Example

Read it as a sentence: turn the value in F5, which holds the result of 1/0, into text, which gives #DIV/0!.

Practice this in the app

Syntax

VALUETOTEXT(value, [format])

Arguments in [square brackets] are optional.

value (required)
The value to convert.
format (optional)
0 concise (default); 1 strict, with quotes around text.

Returns: The value as text.

What Excel actually returns

Each formula below was run in desktop Excel. The result is exactly what the cell showed, errors included.

FormulaExcel showsCase
=VALUETOTEXT("abc") abc Concise text
=VALUETOTEXT("abc",1) "abc" Strict text
=VALUETOTEXT(12.5) 12.5 Number
=VALUETOTEXT(TRUE,1) TRUE Bool strict
=VALUETOTEXT({1,"a"},1) 1 Array spills
=VALUETOTEXT(Data!F5) #DIV/0! Error
=VALUETOTEXT(Data!F1) Blank
=VALUETOTEXT(1,2) #VALUE! Bad format

The Data sheet these formulas read

A cell that starts with = holds that formula.

Watch out for

  • Errors are converted to text instead of propagating.

Where it works

Excel
VALUETOTEXT arrived in Excel 2021. Older versions do not have it.
Google Sheets
No direct equivalent. Use TO_TEXT for a similar result.

Part of Text functions. Every result on this page was measured in desktop Excel, build 16.0.20527. Last updated .