Custom Fields

Collect additional information from customers at checkout.

What Are Custom Fields?

Custom fields let you gather extra data during checkout:

• Player usernames
• Server selection
• Gift recipient info
• Special instructions
• Character names

Creating Custom Fields

1. Go to Settings > Custom Fields
2. Click Add Field
3. Configure the field
4. Assign to products

Field Types

Text Field

Single line text input:

• Player username
• Character name
• Gamertag

Text Area

Multi-line text input:

• Special instructions
• Custom messages
• Long descriptions

Dropdown

Select from predefined options:

• Server selection
• Size selection
• Tier choice

Checkbox

Yes/no toggle:

• Gift wrapping
• Terms acceptance
• Newsletter signup

Number

Numeric input:

• Quantity modifiers
• Level selection
• Coordinates

Color Picker

Hex color selection:

• Custom colors for personalization
• Theme preferences
• Returns hex code (e.g., #FF5500)

Field Settings

Basic Settings

Setting	Description
Label	Field name shown to customer
Placeholder	Example text in empty field
Help Text	Description below field
Required	Must be filled to checkout

Validation

Option	Description
Min Length	Minimum characters
Max Length	Maximum characters
Pattern	Regex validation
Options	Dropdown choices

Example: Player Username

Label: Minecraft Username
Placeholder: Enter your exact username
Help Text: Case-sensitive, exactly as shown in-game
Required: Yes
Min Length: 3
Max Length: 16

Assigning to Products

Per-Product Fields

Assign fields to specific products:

1. Edit the product
2. Go to Custom Fields tab
3. Select fields to include
4. Set field order

Global Fields

Apply to all products:

1. When creating field
2. Enable Apply to All Products
3. Field appears on all checkouts

Using Field Data

In Delivery Commands

Use field values in game commands:

Placeholder	Value
{field.username}	Customer's username field
{field.server}	Selected server
{field.message}	Custom message

Example Command

give {field.username} vip_kit 1

If customer entered "StevePlayer":

give StevePlayer vip_kit 1

In Order Details

View submitted data in:

• Order detail page
• Order emails
• Exported data

Dropdown Configuration

Adding Options

For dropdown fields:

1. Click Add Option
2. Enter option value
3. Enter display label
4. Repeat for all options

Example: Server Selection

Options:
- us-east -> US East Server
- us-west -> US West Server
- eu-central -> EU Central Server

Default Selection

Set a default option:

• Pre-selected at checkout
• Customer can change
• Good for most common choice

Conditional Fields

Show fields based on conditions:

Product-Based

Different fields per product:

• Rank products: Username required
• Server products: Server selection
• Gift cards: Recipient email

Option-Based

Show field when option selected:

• "Gift this item?" checkbox
• If checked, show recipient fields

Field Validation

Built-in Validation

Setting	Description
Required	Field must not be empty
Min Length	Minimum character count
Max Length	Maximum character count
Min/Max Value	For number fields only

Custom Patterns

Use regex for custom validation:

Minecraft username: ^[a-zA-Z0-9_]{3,16}$
Steam ID: ^[0-9]{17}$
Discord username: ^[a-z0-9_.]{2,32}$

Validation Messages

Customize error messages:

• Clear explanation
• How to fix
• Example of valid input

Managing Responses

Viewing Responses

See all submitted data:

1. Go to order detail
2. Custom fields section
3. All values displayed

Exporting Data

Include custom fields in exports:

• Order export includes all fields
• Filter by field values
• Analyze in spreadsheet

Editing Responses

If customer made an error:

1. Open order
2. Edit custom field value
3. Retry delivery if needed

Best Practices

Field Design

• Clear, descriptive labels
• Helpful placeholder text
• Concise help text
• Appropriate validation

User Experience

• Only ask what's necessary
• Logical field order
• Group related fields
• Mobile-friendly

Data Quality

• Validate input format
• Provide examples
• Confirm important fields
• Handle edge cases

Common Use Cases

Game Server Delivery

Field: In-Game Username
Type: Text
Required: Yes
Validation: ^[a-zA-Z0-9_]{3,16}$
Used in: {field.username}

Multi-Server Stores

Field: Select Server
Type: Dropdown
Options: Server 1, Server 2, Server 3
Used for: Routing delivery

Gift Purchases

Field: Gift for Someone?
Type: Checkbox

Field: Recipient Email (conditional)
Type: Email
Show when: Gift checkbox checked

Custom Messages

Field: Personal Message
Type: Text Area
Max Length: 200
Used in: {field.message}