Legacy Documentation: Version 4.6
Language: English
Scroll Rect
Auto Layout

Input Field

Suggest a change

Success!

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.

Close

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.

Close

Cancel

An Input Field is not a visible UI control but rather a way to make the text of a Text Control editable.

A Text control with the editing caret added by an Input Field
A Text control with the editing caret added by an Input Field

Properties

Property: Function:
Text The Text control to be made editable by this Input Field.
Starting Value The initial text placed in the field before editing begins.
Character Limit The maximum number of characters that the user can type into the field.
Active Text Color The color of the editable text (which may be different from the color specified in the Text control).
Selection Color The background color of the selected portion of text.
Multi Line Should the field let the user insert line breaks with the enter/return key?
Interactable Will this component will accept input? See Interactable.
Transition Properties that determine the way the control responds visually to user actions. See Transition Options.
Navigation Properties that determine the sequence of controls. See Navigation Options.

Description

The Input Field script can be added to any existing Text control object from the menu (Component > UI > Input Field). Having done this, you should also drag the object to the Input Field’s Text property to enable editing.

The Text property of the Text control itself will change as the user types and the value can be retrieved from a script after editing. Note that Rich Text is intentionally not supported for editable Text controls; the field will apply any Rich Text markup instantly when typed but the markup essentially “disappears” and there is no subsequent way to change or remove the styling.

Scroll Rect
Auto Layout