Legacy Documentation: Version 4.6.2
Language: English
Text Mesh

Text Asset

Suggest a change


Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.


Sumbission failed

For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.



Switch to Scripting

Text Assets are a format for imported text files. When you drop a text file into your Project Folder, it will be converted to a Text Asset. The supported text formats are:

  • .txt

  • .html

  • .htm

  • .xml

  • .bytes

  • .json

  • .csv

  • .yaml

  • .fnt

The Text Asset Inspector
The Text Asset Inspector


Property: Function:
Text The full text of the asset as a single string.


The Text Asset is a very specialized use case. It is extremely useful for getting text from different text files into your game while you are building it. You can write up a simple .txt file and bring the text into your game very easily. It is not intended for text file generation at runtime. For that you will need to use traditional Input/Output programming techniques to read and write external files.

Consider the following scenario. You are making a traditional text-heavy adventure game. For production simplicity, you want to break up all the text in the game into the different rooms. In this case you would make one text file that contains all the text that will be used in one room. From there it is easy to make a reference to the correct Text Asset for the room you enter. Then with some customized parsing logic, you can manage a large amount of text very easily.

Binary data

A special feature of the text asset is that it can be used to store binary data. By giving a file the extension .bytes it can be loaded as a text asset and the data can be accessed through the bytes property.

For example put a jpeg file into the Resources folder and change the extension to .bytes, then use the following script code to read the data at runtime:

//Load texture from disk
TextAsset bindata= Resources.Load("Texture") as TextAsset;
Texture2D tex = new Texture2D(1,1);


  • Text Assets are serialized like all other assets in a build. There is no physical text file included when you publish your game.
  • Text Assets are not intended to be used for text file generation at runtime.
Text Mesh