Text

VALUETOTEXT Formula

VALUETOTEXT converts any value — number, boolean, error, or formula result — into its text representation. It is useful for building debug views, logging formulas, or displaying values that would otherwise be interpreted as numbers or dates.

Syntax

VALUETOTEXT(value, [format])
ParameterDescription
value Parameter of the VALUETOTEXT function.
[format] (Optional.) Parameter of the VALUETOTEXT function.
Try VALUETOTEXT in Viztab — free, no signup

Examples

Convert number to text

Formula
=VALUETOTEXT(12345)
Returns "12345" as a text string. The value is left-aligned in the cell and treated as text for functions like LEFT, MID, etc.

Show formula result type

Formula
=VALUETOTEXT(TRUE)
Returns "TRUE" as text. Unlike T() which returns empty for non-text values, VALUETOTEXT converts everything to its text form.

Quoted format

Formula
=VALUETOTEXT("Hello", 1)
Returns '"Hello"' — with format argument 1, text values are wrapped in quotes so you can distinguish text from numbers in output.

Common Errors

#VALUE!

Occurs if the format argument is not 0 or 1.

Tips

Format 0 vs 1

Format 0 (default) gives concise output. Format 1 wraps text in quotes and preserves special characters — useful for debugging.

Unlike TEXT function

TEXT requires a format string (like "0.00"). VALUETOTEXT needs no format — it just converts the raw value to its literal text representation.

Use for display columns

In mixed-type data, VALUETOTEXT lets you display all values uniformly as text while preserving their original representation.

Try VALUETOTEXT in Viztab

Import your data and use VALUETOTEXT with 370+ other formulas. No signup required.

Open Viztab

Related Formulas