Home Docs Text

Text Input

Free-form text input for collecting player responses.

Overview

The text field type allows players to enter free-form text responses. This is the most flexible input type and can accept any string or numeric value.

Best for: Comments, feedback, bug descriptions, usernames, email addresses, or any open-ended responses.

Field Structure

key
string required

Unique identifier for this field.

label
string required

Display label shown to the player.

type
string required

Must be set to text

value
string | number required

The text value entered by the player. Can be a string or numeric value.

Example

{
  "key": "feedback_comments",
  "label": "What did you think of the game?",
  "type": "text",
  "value": "I really enjoyed the gameplay mechanics and the story was engaging!"
}

Additional Examples

Bug Description

{
  "key": "bug_description",
  "label": "Please describe the bug",
  "type": "text",
  "value": "The character freezes when jumping near the edge of the platform"
}

Player Identifier

{
  "key": "username",
  "label": "Your in-game name",
  "type": "text",
  "value": "ProGamer123"
}

Numeric Text

{
  "key": "playtime_hours",
  "label": "How many hours have you played?",
  "type": "text",
  "value": 25
}

Validation Rules

  • Value must be a string or number
  • Cannot be empty or null
  • No maximum length enforced by default (limited by database storage)

Common Use Cases

Feedback & Comments

Collect detailed player opinions, suggestions, and general feedback about your game.

Bug Reports

Let players describe bugs, glitches, or unexpected behavior in their own words.

Player Information

Capture usernames, email addresses, or other identifying information.

Custom Data

Store any custom string or numeric data that doesn't fit other input types.